numpy.recarray.item#

方法

recarray.item(*args)#

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

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

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

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

  • int_type 元組：功能與單個 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)
在本頁面上