numpy.rint

numpy.rint(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'rint'>

將陣列元素四捨五入到最接近的整數。

參數:

xarray_like

輸入陣列。

outndarray, None, 或 ndarray 和 None 的 tuple, optional

儲存結果的位置。 如果提供，則必須具有輸入廣播到的形狀。 如果未提供或為 None，則會傳回新配置的陣列。 tuple（僅可能作為關鍵字引數）的長度必須等於輸出的數量。

wherearray_like, optional

此條件會廣播到輸入。 在條件為 True 的位置，out 陣列將設定為 ufunc 結果。 在其他位置，out 陣列將保留其原始值。 請注意，如果透過預設 out=None 建立未初始化的 out 陣列，則其中條件為 False 的位置將保持未初始化。

**kwargs

對於其他僅限關鍵字的引數，請參閱 ufunc 文件。

傳回:

outndarray 或 scalar

輸出陣列的形狀和類型與 x 相同。 如果 x 是純量，則這是一個純量。

另請參閱

fix, ceil, floor, trunc

註解

對於正好在四捨五入十進位值之間的值，NumPy 會四捨五入到最接近的偶數值。 因此，1.5 和 2.5 四捨五入到 2.0，-0.5 和 0.5 四捨五入到 0.0 等。

範例

>>> import numpy as np
>>> a = np.array([-1.7, -1.5, -0.2, 0.2, 1.5, 1.7, 2.0])
>>> np.rint(a)
array([-2., -2., -0.,  0.,  2.,  2.,  2.])