numpy.ma.MaskedArray.item#

method

ma.MaskedArray.item(*args)#

将数组的元素复制到标准 Python 标量并返回.

参数:
args参数(可变数量和类型)

  • none:在这种情况下,该方法仅适用于具有一个元素的数组 ( a.size == 1 ),该元素被复制到标准 Python 标量对象中并返回.

  • int_type:此参数被解释为数组中的一个扁平索引,用于指定要复制和返回的元素.

  • int_types 元组:其功能与单个 int_type 参数相同,不同之处在于该参数被解释为数组中的一个 nd-index.

返回:
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

对于具有 object dtype 的数组,元素按原样返回.

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