numpy.matrix.item#

方法

matrix.item(*args)#

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

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

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

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

  • int_type 的 tuple：功能如同單一 int_type 引數，不同之處在於此引數會被解讀為陣列的 nd-index。

回傳值:
z標準 Python 純量物件

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

註解

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

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