Spec-Zone.ru › NumPy 1.17

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.17.0/reference/generated/numpy.format_float_positional.html

Spec-Zone.ru

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