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».

Параметры

xpython float или 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'