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, min_digits=None)[source]#

以位置標記法將浮點純量格式化為十進位字串。

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

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

要格式化的值。

precision非負整數或 None，可選

要列印的最大位數。如果 unique 為 True，則可以為 None，但如果 unique 為 False，則必須為整數。

unique布林值，可選

如果 True，使用數字生成策略，透過明智的捨入，給出唯一識別浮點數與相同型別其他值的最短表示法。如果給定 precision，則可以列印比必要位數更少的位數，或者如果給定 min_digits，則可以列印更多位數，在這些情況下，最後一位數字會以無偏捨入方式捨入。如果 False，則產生數字的方式如同列印無限精度值，並在 precision 位數後停止，並以無偏捨入方式捨入剩餘值

fractional布林值，可選

如果 True，precision 和 min_digits 的截止值是指小數點後數字的總數，包括前導零。如果 False，precision 和 min_digits 是指小數點之前或之後的有效數字總數，忽略前導零。

trim‘k’、‘.’、‘0’、‘-’ 之一，可選

控制後處理修剪尾隨數字，如下所示

  • ‘k’ : 保留尾隨零，保留小數點（不修剪）

  • ‘.’ : 修剪所有尾隨零，保留小數點

  • ‘0’ : 修剪除小數點前零以外的所有零。如果缺少零，則插入零。

  • ‘-’ : 修剪尾隨零和任何尾隨小數點

sign布林值，可選

是否顯示正值的符號。

pad_left非負整數，可選

在字串的左側填充空白，直到小數點左側至少有那麼多字元。

pad_right非負整數，可選

在字串的右側填充空白，直到小數點右側至少有那麼多字元。

min_digits非負整數或 None，可選

要列印的最小位數。僅在 unique=True 時有效，在這種情況下，可能會列印超過唯一識別該值所需的額外位數，並捨入最後一個額外位數。

版本 1.21.0 新增功能。

返回：
rep字串

浮點數值的字串表示形式

另請參閱

format_float_scientific

範例

>>> import numpy as np
>>> 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'
在此頁面上