numpy.ndarray.item#

方法

ndarray.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)
在此頁面上