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

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

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

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

array.array(typecode[, initializer])¶

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

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

array.ArrayType¶

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

array.typecodes¶

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

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

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

array.typecode¶

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

array.itemsize¶

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

array.append(x)¶

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

array.buffer_info()¶

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

Примечание

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

array.byteswap()¶

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

array.count(x)¶

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

array.extend(iterable)¶

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

array.fromfile(f, n)¶

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

array.fromlist(list)¶

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

array.fromstring(s)¶

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

array.fromunicode(s)¶

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

array.index(x)¶

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

array.insert(i, x)¶

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

array.pop([i])¶

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

array.remove(x)¶

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

array.reverse()¶

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

array.tofile(f)¶

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

array.tolist()¶

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

array.tostring()¶

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

array.tounicode()¶

Преобразует массив в строку Unicode. Массив должен быть типа 'u'; в противном случае возбуждается ValueError. Используйте array.tostring().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])