Spec-Zone.ru › NumPy 1.13

numpy.ndarray.item

ndarray.item(*args)

Копирует элемент массива в стандартный скаляр Python и возвращает его.

Параметры:

*args : Аргументы (переменное количество и тип)

  • ничего: в этом случае метод работает только для массивов с одним элементом (a.size == 1), элемент которого копируется в стандартный скалярный объект Python и возвращается.
  • тип int: этот аргумент интерпретируется как плоский индекс в массиве, определяющий, какой элемент скопировать и вернуть.
  • кортеж из типов int: работает так же, как и единственный аргумент типа int, за исключением того, что аргумент интерпретируется как индекс nd в массиве.
Возвращает:

z : Стандартный скалярный объект Python

Копия указанного элемента массива в виде подходящего скаляра Python

Замечания

Когда тип данных a — longdouble или clongdouble, item() возвращает скалярный массивный объект, потому что нет доступного скаляра Python, который не потерял бы информацию. Массивы типа Void возвращают объект буфера для item(), если не определены поля, в этом случае возвращается кортеж.

item очень похож на a[args], за исключением того, что вместо скаляра массива возвращается стандартный скаляр Python. Это может быть полезно для ускорения доступа к элементам массива и выполнения арифметических операций над элементами массива с использованием оптимизированной математики Python.

Примеры

>>> x = np.random.randint(9, size=(3, 3))
>>> x
array([[3, 1, 7],
       [2, 8, 3],
       [8, 5, 3]])
>>> x.item(3)
2
>>> x.item(7)
5
>>> x.item((0, 1))
1
>>> x.item((2, 2))
3

© 2008–2016 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.10.1/reference/generated/numpy.ndarray.item.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API