Spec-Zone.ru › NumPy 1.16

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

Параметры:
x : python float or numpy floating scalar

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

precision : non-negative integer or None, optional

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

unique : boolean, optional

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

fractional : boolean, optional

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

trim : one of ‘k’, ‘.’, ‘0’, ‘-‘, optional

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

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

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

pad_left : non-negative integer, optional

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

pad_right : non-negative integer, optional

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

Возвращает:
rep : string

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

См. также

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'

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.16.1/reference/generated/numpy.format_float_positional.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API