numpy.format_float_scientific#

numpy.format_float_scientific(x, precision=None, unique=True, trim='k', sign=False, pad_left=None, exp_digits=None, min_digits=None)[source]#

将浮点标量格式化为科学记数法的十进制字符串。

提供对舍入、修剪和填充的控制。使用并假设 IEEE 无偏舍入。使用“Dragon4”算法。

参数:
xpython 浮点数或 numpy 浮点标量

要格式化的值。

precision非负整数或 None,可选

要打印的最多位数。如果 uniqueTrue,则可以为 None,但如果 unique 为 False,则必须为整数。

unique布尔值,可选

如果 True,则使用一种数字生成策略,该策略提供最短的表示形式,通过明智的舍入,将浮点数与相同类型的其他值唯一地识别。如果给出 precision,则可以打印比必要更少的数字。如果给出 min_digits,则可以打印更多,在这种情况下,最后一位将使用无偏舍入进行舍入。如果 False,则生成数字就像打印无限精度的值并在 precision 位数后停止一样,使用无偏舍入对剩余的值进行舍入

trim‘k’、‘.’、‘0’、‘-’ 之一,可选

控制对尾随数字的后处理修剪,如下所示

  • ‘k’:保留尾随零,保留小数点(不修剪)

  • ‘.’:修剪所有尾随零,保留小数点

  • ‘0’:修剪除小数点前的零以外的所有数字。如果缺少零,则插入零。

  • ‘-’:修剪尾随零和任何尾随小数点

sign布尔值,可选

是否显示正值的符号。

pad_left非负整数,可选

在字符串的左侧填充空格,直到至少有这么多字符位于小数点的左侧。

exp_digits非负整数,可选

用零填充指数,直到它包含至少这么多位数。如果省略,则指数将至少为 2 位数。

min_digits非负整数或 None,可选

要打印的最小位数。这仅对 unique=True 有效。在这种情况下,可以打印比唯一标识该值所需的更多数字并进行无偏舍入。

版本 1.21.0 中的新功能。

返回值:
rep字符串

浮点值的字符串表示形式

示例

>>> import numpy as np
>>> np.format_float_scientific(np.float32(np.pi))
'3.1415927e+00'
>>> s = np.float32(1.23e24)
>>> np.format_float_scientific(s, unique=False, precision=15)
'1.230000071797338e+24'
>>> np.format_float_scientific(s, exp_digits=4)
'1.23e+0024'