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’ : сохранять trailing zeros, сохранять десятичную точку (без обрезки)
• ‘.’ : обрезать все trailing zeros, оставить десятичную точку
• ‘0’ : обрезать все, кроме нуля перед десятичной точкой. Вставить ноль, если его нет.
• ‘-‘ : обрезать trailing zeros и любую trailing десятичную точку

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'