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)[原始碼]#

將浮點純量格式化為科學記號表示法的十進位字串。

提供捨入、修剪和填充的控制。使用並假設 IEEE 無偏捨入。使用 “Dragon4” 演算法。

參數:
xpython 浮點數或 numpy 浮點純量

要格式化的值。

precision非負整數或 None，選用

要列印的最大位數。如果 unique 為 True，則可以為 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字串

浮點數值的字串表示形式

另請參閱

format_float_positional

範例

>>> 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'