numpy.char.chararray.item#

方法

char.chararray.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)