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, min_digits=None)[source]

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

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

Параметры:

xчисло с плавающей точкой Python или число с плавающей точкой NumPy

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

precisionнеотрицательное целое число или None, необязательно

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

uniqueбулево значение, необязательно

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

fractionalбулево значение, необязательно

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

trimодно из ‘k’, ‘.’, ‘0’, ‘-’, необязательно

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

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

signбулево значение, необязательно

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

pad_leftнеотрицательное целое число, необязательно

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

pad_rightнеотрицательное целое число, необязательно

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

min_digitsнеотрицательное целое число или None, необязательно

Минимальное количество цифр для вывода. Действует только если unique=True в этом случае дополнительные цифры, превышающие необходимые для уникальной идентификации значения, могут быть напечатаны с округлением последней дополнительной цифры.

Добавлена в версии 1.21.0.

Возвращаемое значение:

repстрока

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

См. также

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'