numpy.ma.MaskedArray.item

方法

ma.MaskedArray.item(*args)

複製陣列的一個元素到標準 Python 純量並回傳。

參數:

*args引數（可變數量和型別）

• none: 在此情況下，此方法僅適用於具有一個元素的陣列 (a.size == 1)，該元素會被複製到標準 Python 純量物件並回傳。

• int_type: 此引數會被解釋為陣列的扁平索引，指定要複製和回傳哪個元素。

• tuple of int_types: 功能如同單一 int_type 引數，不同之處在於此引數會被解釋為陣列的 nd 索引。

回傳值:

z標準 Python 純量物件

陣列指定元素的副本，作為合適的 Python 純量

註解

當 a 的資料型別為 longdouble 或 clongdouble 時，item() 會回傳純量陣列物件，因為沒有可用的 Python 純量不會遺失資訊。Void 陣列會為 item() 回傳緩衝區物件，除非定義了欄位，在這種情況下會回傳元組。

item 非常類似於 a[args]，除了它回傳的是標準 Python 純量，而不是陣列純量。這對於加速存取陣列元素以及使用 Python 優化的數學對陣列元素進行算術運算非常有用。

範例

>>> import numpy as np
>>> np.random.seed(123)
>>> x = np.random.randint(9, size=(3, 3))
>>> x
array([[2, 2, 6],
       [1, 3, 6],
       [1, 0, 1]])
>>> x.item(3)
1
>>> x.item(7)
0
>>> x.item((0, 1))
2
>>> x.item((2, 2))
1

對於具有物件 dtype 的陣列，元素會依原樣回傳。

>>> a = np.array([np.int64(1)], dtype=object)
>>> a.item() #return np.int64
np.int64(1)