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

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

Примечания:

1. Типовой код 'u' соответствует устаревшему символу Unicode Python (Py_UNICODE, который является wchar_t). В зависимости от платформы он может быть 16- или 32-битным.

   'u' будет удалён вместе с остальной частью Py_UNICODE API.

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

2. Типовые коды 'q' и 'Q' доступны, только если компилятор C платформы, используемый для сборки Python, поддерживает C long long, или, в Windows, __int64.

   Новое в версии 3.3.

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

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

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

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

If given a list or string, the initializer is passed to the new array’s fromlist(), frombytes(), or fromunicode() method (see below) to add initial items to the array. Otherwise, the iterable initializer is passed to the extend() method.

array.typecodes¶

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

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

Также поддерживаются следующие элементы данных и методы:

array.typecode¶

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

array.itemsize¶

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

array.append(x)¶

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

array.buffer_info()¶

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

Примечание

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

array.byteswap()¶

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

array.count(x)¶

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

array.extend(iterable)¶

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

array.frombytes(s)¶

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

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

array.fromfile(f, n)¶

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

array.fromlist(list)¶

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

array.fromstring()¶

Устаревший псевдоним для frombytes().

array.fromunicode(s)¶

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

array.index(x)¶

Возвращает наименьшее i, такое, что i является индексом первого вхождения x в массиве.

array.insert(i, x)¶

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

array.pop([i])¶

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

array.remove(x)¶

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

array.reverse()¶

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

array.tobytes()¶

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

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

array.tofile(f)¶

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

array.tolist()¶

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

array.tostring()¶

Устаревший псевдоним для tobytes().

array.tounicode()¶

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

При выводе или преобразовании объекта массива в строку он представляется как 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])