array – Эффективные массивы числовых значений¶array – Efficient arrays of numeric values

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

Примечания:

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

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

   Устарело с версии 3.3, будет удалено в версии 3.16: Пожалуйста, переходите на код типа 'w'.

2. Добавлено в версии 3.13.

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

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

array.typecodes¶

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

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

class array.array(typecode[, initializer])¶

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

Если передан объект bytes или bytearray, инициализатор передаётся методу frombytes() нового массива; если передана строка Unicode, инициализатор передаётся методу fromunicode(); в противном случае итератор инициализатора передаётся методу extend() для добавления начальных элементов в массив.

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

Массивы являются обобщёнными по типу своего содержимого.

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

typecode¶

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

itemsize¶

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

append(value, /)¶

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

buffer_info()¶

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

Примечание

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

byteswap()¶

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

count(value, /)¶

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

extend(iterable, /)¶

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

frombytes(buffer, /)¶

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

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

fromfile(f, n, /)¶

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

fromlist(list, /)¶

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

fromunicode(ustr, /)¶

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

index(value[, start[, stop]])¶

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

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

insert(index, value, /)¶

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

pop(index=-1, /)¶

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

remove(value, /)¶

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

clear()¶

Удаляет все элементы из массива.

Добавлено в версии 3.13.

reverse()¶

Изменяет порядок элементов в массиве на обратный.

tobytes()¶

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

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

tofile(f, /)¶

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

tolist()¶

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

tounicode()¶

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

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

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