numpy.format_float_positional

numpy.format_float_positional(x, precision=None, unique=True, fractional=True, trim='k', sign=False, pad_left=None, pad_right=None) [source]

Форматирование числового скаляра с плавающей точкой в виде десятичной строки в позиционной нотации.

Предоставляет контроль над округлением, обрезкой и заполнением. Использует и предполагает несмещённое округление IEEE. Использует алгоритм «Dragon4».

Параметры

xpython float or numpy floating scalar

Значение для форматирования.

precisionnon-negative integer or None, optional

Максимальное количество цифр для вывода. Может быть None, если unique является True, но должно быть целым числом, если unique является False.

uniqueboolean, optional

Если True, используется стратегия генерации цифр, которая даёт самое короткое представление, однозначно идентифицирующее число с плавающей точкой среди других значений того же типа, путём разумного округления. Если precision отсутствует, выводятся все необходимые цифры, в противном случае генерация цифр прекращается после precision цифр, а оставшееся значение округляется. Если False, цифры генерируются так, как если бы выводилось значение с бесконечной точностью и остановка происходила после precision цифр, округляя оставшееся значение.

fractionalboolean, optional

Если True, отсечение precision цифр относится к общему числу цифр после десятичной точки, включая ведущие нули. Если False, precision относится к общему числу значащих цифр, перед или после десятичной точки, игнорируя ведущие нули.

trimone of ‘k’, ‘.’, ‘0’, ‘-‘, optional

Управляет пост-обработкой обрезки хвостовых цифр следующим образом:

• ‘k’ : сохранять хвостовые нули, сохранять десятичную точку (без обрезки)
• ‘.’ : обрезать все хвостовые нули, оставить десятичную точку
• ‘0’ : обрезать все, кроме нуля перед десятичной точкой. Вставить ноль, если его нет.
• ‘-‘ : обрезать хвостовые нули и любую хвостовую десятичную точку

signboolean, optional

Показывать ли знак для положительных значений.

pad_leftnon-negative integer, optional

Заполнять левую часть строки пробелами до тех пор, пока не будет хотя бы столько символов слева от десятичной точки.

pad_rightnon-negative integer, optional

Заполнять правую часть строки пробелами до тех пор, пока не будет хотя бы столько символов справа от десятичной точки.

Возвращает

repstring

Строковое представление значения с плавающей точкой

См. также

format_float_scientific

Примеры

>>> np.format_float_positional(np.float32(np.pi))
'3.1415927'
>>> np.format_float_positional(np.float16(np.pi))
'3.14'
>>> np.format_float_positional(np.float16(0.3))
'0.3'
>>> np.format_float_positional(np.float16(0.3), unique=False, precision=10)
'0.3000488281'