`ndarray.tolist()`

Метод a.tolist() (есть и функция np.ndarray.tolist) возвращает содержимое массива как обычный Python-список (или вложенные списки для многомерных массивов). Элементы автоматически приводятся к ближайшим Python-типам (int, float, bool), что бывает удобно для сериализации в JSON.

Сигнатура

ndarray.tolist()

Параметры

Параметров нет. Вызывается как метод массива.

Возвращаемое значение

Обычный Python-объект: список (или вложенные списки), либо скаляр для 0D массива.

Примеры

Пример 1. Простой 1D-массив в список.

import numpy as np

a = np.array([1, 2, 3, 4])
lst = a.tolist()
print(lst, type(lst))

[1, 2, 3, 4] <class 'list'>

Пример 2. 2D-массив — вложенные списки.

m = np.array([[1, 2], [3, 4]])
print(m.tolist())

[[1, 2], [3, 4]]

Пример 3. Приведение типа np.int64 → int.

a = np.array([1, 2, 3])
print(type(a[0]))
print(type(a.tolist()[0]))

<class 'numpy.int64'>
<class 'int'>

Пример 4. Сериализация в JSON.

import json

readings = np.array([512, 480, 600])
payload = json.dumps({"adc": readings.tolist()})
print(payload)

{"adc": [512, 480, 600]}

Пример 5. 0D-массив возвращает скаляр.

a = np.array(42)
print(a.tolist(), type(a.tolist()))

42 <class 'int'>

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации NumPy (https://numpy.org/doc/stable/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.

ndarray.tolist()