Spec-Zone.ru › NumPy 1.14

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 или numpy

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

precision : неотрицательное целое число или None, необязательно

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

unique : boolean, необязательно

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

fractional : boolean, необязательно

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

trim : одно из ‘k’, ‘.’, ‘0’, ‘-‘, необязательно

Управляет обрезанием конечных цифр после обработки, как следует:

k : сохраняет конечные нули, сохраняет десятичную точку (без обрезки) . : обрезает все конечные нули, оставляет десятичную точку 0 : обрезает все, кроме нуля перед десятичной точкой. Вставляет

ноль, если он отсутствует.

  • : обрезает конечные нули и конечную десятичную точку

sign : boolean, необязательно

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

pad_left : неотрицательное целое число, необязательно

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

pad_right : неотрицательное целое число, необязательно

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

Возвращает:

rep : строка

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

См. также

format_float_scientific

Примеры

>>> np.format_float_scientific(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.14.5/reference/generated/numpy.format_float_positional.html

Spec-Zone.ru

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