array — Эффективные массивы числовых значений

Этот модуль определяет тип объекта, который может компактно представлять массив основных значений: символов, целых чисел, чисел с плавающей точкой. Массивы являются типами последовательностей и ведут себя очень похоже на списки, за исключением того, что тип объектов, хранящихся в них, ограничен. Тип указывается во время создания объекта с помощью кода типа, который представляет собой одиночный символ. Определены следующие коды типов:

Примечания:

1. Может составлять 16 или 32 бита в зависимости от платформы.

   Изменено в версии 3.9: array('u') теперь использует wchar_t в качестве типа C вместо устаревшего Py_UNICODE. Это изменение не влияет на его поведение, так как Py_UNICODE является алиасом wchar_t с Python 3.3.

   Устаревшее с версии 3.3, будет удалено в версии 4.0.

Фактическое представление значений определяется архитектурой машины (строго говоря, реализацией C). Фактический размер можно получить через атрибут array.itemsize.

Модуль определяет следующий элемент:

array.typecodes

Строка со всеми доступными кодами типов.

Модуль определяет следующие типы:

class array.array(typecode[, initializer])

Новый массив, элементы которого ограничены typecode, и инициализирован из необязательного значения initializer, которое должно быть списком, объектом-подобным байтам или итерируемым объектом над элементами соответствующего типа.

Если задан список или строка, инициализатор передаётся методу нового массива fromlist(), frombytes() или fromunicode() (см. ниже), чтобы добавить начальные элементы в массив. В противном случае, итерируемый инициализатор передаётся методу extend().

Объекты массивов поддерживают обычные операции над последовательностями: индексирование, срезы, конкатенацию и умножение. При использовании присваивания среза присваиваемое значение должно быть объектом массива с тем же кодом типа; во всех других случаях генерируется TypeError. Объекты массивов также реализуют интерфейс буфера и могут использоваться там, где поддерживаются объекты, похожие на байты.

Вызывает событие аудита array.__new__ с аргументами typecode, initializer.

typecode

Символ типа, используемый для создания массива.

itemsize

Длина в байтах одного элемента массива во внутреннем представлении.

append(x)

Добавляет новый элемент со значением x в конец массива.

buffer_info()

Возвращает кортеж (address, length) , содержащий текущий адрес памяти и длину в элементах буфера, используемого для хранения содержимого массива. Размер буфера памяти в байтах можно вычислить как array.buffer_info()[1] * array.itemsize. Это иногда бывает полезно при работе с низкоуровневыми (и по своей природе небезопасными) интерфейсами ввода-вывода, которые требуют адресов памяти, таких как некоторые ioctl() операции. Возвращенные числа действительны до тех пор, пока существует массив и к нему не применяются операции, изменяющие длину.

Примечание

При использовании объектов массивов из кода, написанного на C или C++ (единственный способ эффективного использования этой информации), имеет больше смысла использовать интерфейс буфера, поддерживаемый объектами массивов. Этот метод сохранён для обратной совместимости и следует избегать в новом коде. Интерфейс буфера документирован в Протокол буфера.

byteswap()

Производит «перестановку байтов» всех элементов массива. Это поддерживается только для значений размером 1, 2, 4 или 8 байт; для других типов значений генерируется RuntimeError. Это полезно при чтении данных из файла, записанного на машине с другим порядком байтов.

count(x)

Возвращает количество вхождений x в массиве.

extend(iterable)

Добавляет элементы из iterable в конец массива. Если iterable является другим массивом, он должен иметь точно такой же код типа; в противном случае будет поднято исключение TypeError. Если iterable не является массивом, он должен быть итерируемым, и его элементы должны быть подходящего типа для добавления в массив.

frombytes(s)

Добавляет элементы из строки, интерпретируя строку как массив машинных значений (как если бы она была считана из файла с помощью метода fromfile()).

New in version 3.2: fromstring() переименован в frombytes() для ясности.

fromfile(f, n)

Считывает n элементов (как машинные значения) из объекта файла f и добавляет их в конец массива. Если доступно меньше n элементов, генерируется EOFError, но доступные элементы всё равно вставляются в массив.

fromlist(list)

Добавляет элементы из списка. Это эквивалентно for x in list: a.append(x), за исключением того, что если возникает ошибка типа, массив не изменяется.

fromunicode(s)

Расширяет этот массив данными из заданной строки Unicode. Массив должен быть массивом типа 'u'; в противном случае генерируется ValueError. Используйте array.frombytes(unicodestring.encode(enc)) для добавления данных Unicode в массив другого типа.

index(x[, start[, stop]])

Возвращает наименьшее i такое, что i — индекс первого вхождения x в массиве. Необязательные аргументы start и stop могут быть заданы для поиска x в подпоследовательности массива. Генерирует ValueError, если x не найдено.

Изменено в версии 3.10: Добавлены необязательные параметры start и stop.

insert(i, x)

Вставляет новый элемент со значением x в массив перед позицией i. Отрицательные значения обрабатываются как относительные к концу массива.

pop([i])

Удаляет элемент с индексом i из массива и возвращает его. Необязательный аргумент по умолчанию -1, поэтому по умолчанию удаляется и возвращается последний элемент.

remove(x)

Удаляет первое вхождение x из массива.

reverse()

Меняет порядок элементов в массиве.

tobytes()

Преобразует массив в массив машинных значений и возвращает представление в виде байтов (такую же последовательность байтов, которая была бы записана в файл методом tofile()).

New in version 3.2: tostring() переименован в tobytes() для ясности.

tofile(f)

Записывает все элементы (как машинные значения) в объект файла f.

tolist()

Преобразует массив в обычный список с теми же элементами.

tounicode()

Преобразует массив в строку Unicode. Массив должен быть массивом типа 'u'; в противном случае генерируется ValueError. Используйте array.tobytes().decode(enc) для получения строки Unicode из массива другого типа.

При печати объекта массива или его преобразовании в строку он представляется как array(typecode, initializer). initializer опускается, если массив пуст, иначе это строка, если typecode равен 'u', в противном случае это список чисел. Гарантируется, что строка может быть преобразована обратно в массив с тем же типом и значением с помощью eval(), при условии, что класс array был импортирован с помощью from array import array. Примеры:

array('l')
array('u', 'hello \u2641')
array('l', [1, 2, 3, 4, 5])
array('d', [1.0, 2.0, 3.14])