array.md

1> **Источник:** https://python-all.ru/3.2/library/array.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 7.6. [`array`](https://python-all.ru/3.2/library/array.html#module-array) – Эффективные массивы числовых значений89Этот модуль определяет тип объекта, который может компактно представлять массив базовых значений: символы, целые числа, числа с плавающей запятой. Массивы являются последовательностями и ведут себя очень похоже на списки, за исключением того, что тип хранимых в них объектов ограничен. Тип задаётся при создании объекта с помощью *кода типа*, который представляет собой один символ. Определены следующие коды типа:1011| Код типа | Тип C | Тип Python | Минимальный размер в байтах |12| --- | --- | --- | --- |13| `'b'` | знаковый char | int | 1 |14| `'B'` | беззнаковый char | int | 1 |15| `'u'` | Py\_UNICODE | символ Unicode | 2 (см. примечание) |16| `'h'` | знаковый short | int | 2 |17| `'H'` | беззнаковый short | int | 2 |18| `'i'` | знаковый int | int | 2 |19| `'I'` | беззнаковый int | int | 2 |20| `'l'` | знаковый long | int | 4 |21| `'L'` | беззнаковый long | int | 4 |22| `'f'` | float | float | 4 |23| `'d'` | double | float | 8 |2425> **Примечание**26>27> Типовой код `'u'` соответствует символу Unicode в Python. В узких сборках Unicode он занимает 2 байта, в широких – 4 байта.2829Фактическое представление значений определяется архитектурой машины (строго говоря, реализацией C). Фактический размер можно получить через атрибут `itemsize`.3031Модуль определяет следующий тип:3233#### `class array.array(typecode[, initializer])`3435Новый массив, элементы которого ограничены *типовым кодом*, и инициализируется из необязательного значения *инициализатора*, которое должно быть списком, объектом, поддерживающим интерфейс буфера, или итерируемым объектом, содержащим элементы подходящего типа.3637If given a list or string, the initializer is passed to the new array’s [`fromlist()`](https://python-all.ru/3.2/library/array.html#array.array.fromlist), [`frombytes()`](https://python-all.ru/3.2/library/array.html#array.array.frombytes), or [`fromunicode()`](https://python-all.ru/3.2/library/array.html#array.array.fromunicode) method (see below) to add initial items to the array. Otherwise, the iterable initializer is passed to the [`extend()`](https://python-all.ru/3.2/library/array.html#array.array.extend) method.3839#### `array.typecodes`4041Строка со всеми доступными кодами типов.4243Объекты array поддерживают обычные операции последовательностей: индексацию, срезы, конкатенацию и умножение. При использовании присваивания срезу присваиваемое значение должно быть объектом array с тем же кодом типа; во всех остальных случаях возбуждается [`TypeError`](https://python-all.ru/3.2/library/exceptions.html#TypeError). Объекты array также реализуют интерфейс буфера и могут использоваться везде, где поддерживаются буферные объекты.4445Также поддерживаются следующие элементы данных и методы:4647#### `array.typecode`4849Символ кода типа, использованный для создания массива.5051#### `array.itemsize`5253Длина в байтах одного элемента массива во внутреннем представлении.5455#### `array.append(x)`5657Добавляет новый элемент со значением *x* в конец массива.5859#### `array.buffer_info()`6061Возвращает кортеж `(address, length)`, содержащий текущий адрес памяти и количество элементов в буфере, используемом для хранения содержимого массива. Размер буфера памяти в байтах можно вычислить как `array.buffer_info()[1] * array.itemsize`. Это иногда полезно при работе с низкоуровневыми (и по своей сути небезопасными) интерфейсами ввода-вывода, требующими адреса памяти, такими как некоторые операции `ioctl()`. Возвращаемые числа действительны до тех пор, пока массив существует и к нему не применяются операции, изменяющие длину.6263> **Примечание**64>65> При использовании объектов массива из кода, написанного на C или C++ (единственный способ эффективно использовать эту информацию), более разумно использовать буферный интерфейс, поддерживаемый объектами массива. Этот метод сохраняется для обратной совместимости, и его следует избегать в новом коде. Буферный интерфейс описан в [*Протоколе буфера*](https://python-all.ru/3.2/c-api/buffer.html#bufferobjects).6667#### `array.byteswap()`6869«Байт-своп» (перестановка байтов) всех элементов массива. Это поддерживается только для значений размером 1, 2, 4 или 8 байт; для значений других типов возбуждается [`RuntimeError`](https://python-all.ru/3.2/library/exceptions.html#RuntimeError). Это полезно при чтении данных из файла, записанного на машине с другим порядком байтов.7071#### `array.count(x)`7273Возвращает количество вхождений *x* в массиве.7475#### `array.extend(iterable)`7677Добавляет элементы из *iterable* в конец массива. Если *iterable* является другим массивом, он должен иметь *точно такой же* типовой код; в противном случае будет возбуждено [`TypeError`](https://python-all.ru/3.2/library/exceptions.html#TypeError). Если *iterable* не является массивом, он должен быть итерируемым, а его элементы должны быть подходящего типа для добавления в массив.7879#### `array.frombytes(s)`8081Добавляет элементы из строки, интерпретируя строку как машинный массив значений (как если бы он был прочитан из файла с помощью метода [`fromfile()`](https://python-all.ru/3.2/library/array.html#array.array.fromfile)).8283Новое в версии 3.2: [`fromstring()`](https://python-all.ru/3.2/library/array.html#array.array.fromstring) переименована в [`frombytes()`](https://python-all.ru/3.2/library/array.html#array.array.frombytes) для ясности.8485#### `array.fromfile(f, n)`8687Читает *n* элементов (как машинные значения) из [*файлового объекта*](https://python-all.ru/3.2/glossary.html#term-file-object) *f* и добавляет их в конец массива. Если доступно менее *n* элементов, возбуждается [`EOFError`](https://python-all.ru/3.2/library/exceptions.html#EOFError), но доступные элементы всё равно вставляются в массив. *f* должен быть реальным встроенным файловым объектом; что-то другое с методом `read()` не подойдёт.8889#### `array.fromlist(list)`9091Добавляет элементы из списка. Аналогично `for x in list: a.append(x)`, за исключением того, что в случае ошибки типа массив остаётся без изменений.9293#### `array.fromstring()`9495Устаревший псевдоним для [`frombytes()`](https://python-all.ru/3.2/library/array.html#array.array.frombytes).9697#### `array.fromunicode(s)`9899Расширяет массив данными из заданной юникодной строки. Массив должен быть типа `'u'`; в противном случае вызывается [`ValueError`](https://python-all.ru/3.2/library/exceptions.html#ValueError). Используйте `array.frombytes(unicodestring.encode(enc))` для добавления юникодных данных в массив другого типа.100101#### `array.index(x)`102103Возвращает наименьшее *i*, такое, что *i* является индексом первого вхождения *x* в массиве.104105#### `array.insert(i, x)`106107Вставляет новый элемент со значением *x* в массив перед позицией *i*. Отрицательные значения интерпретируются как смещение от конца массива.108109#### `array.pop([i])`110111Удаляет элемент с индексом *i* из массива и возвращает его. Необязательный аргумент по умолчанию равен `-1`, так что по умолчанию удаляется и возвращается последний элемент.112113#### `array.remove(x)`114115Удаляет первое вхождение *x* из массива.116117#### `array.reverse()`118119Изменяет порядок элементов в массиве на обратный.120121#### `array.tobytes()`122123Преобразует массив в машинное представление и возвращает последовательность байтов (ту же, что была бы записана в файл методом [`tofile()`](https://python-all.ru/3.2/library/array.html#array.array.tofile)).124125Новое в версии 3.2: [`tostring()`](https://python-all.ru/3.2/library/array.html#array.array.tostring) переименована в [`tobytes()`](https://python-all.ru/3.2/library/array.html#array.array.tobytes) для ясности.126127#### `array.tofile(f)`128129Записывает все элементы (как машинные значения) в [*файловый объект*](https://python-all.ru/3.2/glossary.html#term-file-object) *f*.130131#### `array.tolist()`132133Преобразует массив в обычный список с теми же элементами.134135#### `array.tostring()`136137Устаревший псевдоним для [`tobytes()`](https://python-all.ru/3.2/library/array.html#array.array.tobytes).138139#### `array.tounicode()`140141Преобразует массив в юникодную строку. Массив должен быть типа `'u'`; в противном случае вызывается [`ValueError`](https://python-all.ru/3.2/library/exceptions.html#ValueError). Используйте `array.tobytes().decode(enc)` для получения юникодной строки из массива другого типа.142143При выводе или преобразовании объекта массива в строку он представляется как `array(typecode, initializer)`. Параметр *initializer* опускается, если массив пуст; в противном случае это строка, если *typecode* равен `'u'`, иначе это список чисел. Гарантируется, что строку можно преобразовать обратно в массив с тем же типом и значением с помощью [`eval()`](https://python-all.ru/3.2/library/functions.html#eval) при условии, что функция [`array()`](https://python-all.ru/3.2/library/array.html#module-array) была импортирована через `from array import array`. Примеры:144145```python146array('l')147array('u', 'hello \u2641')148array('l', [1, 2, 3, 4, 5])149array('d', [1.0, 2.0, 3.14])150```151152> **См. также**153>154> **Модуль [`struct`](https://python-all.ru/3.2/library/struct.html#module-struct)**155>156> Упаковка и распаковка разнородных двоичных данных.157>158> **Модуль [`xdrlib`](https://python-all.ru/3.2/library/xdrlib.html#module-xdrlib)**159>160> Упаковка и распаковка данных внешнего представления (XDR), используемого в некоторых системах удалённого вызова процедур.161>162> **[Руководство по Numerical Python](https://python-all.ru/3.2/library/array.html)**163>164> Расширение Numeric Python (NumPy) определяет другой тип массива; см.165>166> [http://numpy.sourceforge.net/](https://python-all.ru/3.2/library/array.html)167>168> для получения дополнительной информации о Numerical Python. (PDF-версия руководства NumPy доступна по адресу169>170> [http://numpy.sourceforge.net/numdoc/numdoc.pdf](https://python-all.ru/3.2/library/array.html)171>172> ).173