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'