> **Источник:** https://python-all.ru/3.1/library/chunk.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 21.5. `chunk` – Чтение IFF-данных чанками

Этот модуль предоставляет интерфейс для чтения файлов, использующих EA IFF 85 чанки. [\[1\]](https://python-all.ru/3.1/library/chunk.html#id2) Этот формат применяется, как минимум, в Audio Interchange File Format (AIFF/AIFF-C) и Real Media File Format (RMFF). Формат аудиофайлов WAVE тесно связан с ним и также может быть прочитан с помощью этого модуля.

Чанк имеет следующую структуру:

| Смещение | Длина | Содержание |
| --- | --- | --- |
| 0 | 4 | Идентификатор чанка |
| 4 | 4 | Размер чанка в порядке байтов big-endian, без учета заголовка |
| 8 | *n* | Байты данных, где *n* – размер, указанный в предыдущем поле |
| 8 + *n* | 0 или 1 | Байт заполнения, необходимый, если *n* нечётное и используется выравнивание чанков |

Идентификатор представляет собой 4-байтовую строку, которая определяет тип чанка.

Поле размера (32-битное значение, закодированное в порядке байтов big-endian) указывает размер данных чанка, не включая 8-байтовый заголовок.

Обычно файл типа IFF состоит из одного или нескольких чанков. Предлагаемое использование класса [`Chunk`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk), определённого здесь, заключается в создании экземпляра в начале каждого чанка и чтении из него до тех пор, пока он не закончится, после чего можно создать новый экземпляр. В конце файла создание нового экземпляра завершится исключением [`EOFError`](https://python-all.ru/3.1/library/exceptions.html#EOFError).

#### `class chunk.Chunk(file, align=True, bigendian=True, inclheader=False)`

Класс, представляющий чанк. Аргумент *file* должен быть файлоподобным объектом. Экземпляр этого класса разрешён. Единственный необходимый метод – [`read()`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk.read). Если присутствуют методы [`seek()`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk.seek) и [`tell()`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk.tell) и не вызывают исключений, они также используются. Если эти методы присутствуют, но вызывают исключение, предполагается, что они не изменили объект. Если необязательный аргумент *align* равен True, считается, что чанки выровнены по границам 2 байт. Если *align* равен False, выравнивание не предполагается. Значение по умолчанию – True. Если необязательный аргумент *bigendian* равен False, размер чанка считается записанным в порядке little-endian. Это необходимо для аудиофайлов WAVE. Значение по умолчанию – True. Если необязательный аргумент *inclheader* равен True, размер, указанный в заголовке чанка, включает размер заголовка. Значение по умолчанию – False.

Объект [`Chunk`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk) поддерживает следующие методы:

#### `getname()`

Возвращает имя (идентификатор) чанка. Это первые 4 байта чанка.

#### `getsize()`

Возвращает размер чанка.

#### `close()`

Закрывает и пропускает до конца чанка. Это не закрывает нижележащий файл.

Остальные методы будут возбуждать [`IOError`](https://python-all.ru/3.1/library/exceptions.html#IOError), если они вызваны после вызова метода [`close()`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk.close).

#### `isatty()`

Возвращает

`False`

.

#### `seek(pos, whence=0)`

Устанавливает текущую позицию в чанке. Аргумент

*whence*

необязателен и по умолчанию равен

`0`

(абсолютное позиционирование в файле); другие значения –

`1`

(относительно текущей позиции) и

`2`

(относительно конца файла). Возвращаемого значения нет. Если нижележащий файл не поддерживает позиционирование, разрешён только переход вперёд.

#### `tell()`

Возвращает текущую позицию в чанке.

#### `read(size=-1)`

Читает не более

*size*

байт из чанка (меньше, если чтение достигает конца чанка до получения

*size*

байт). Если аргумент

*size*

отрицателен или опущен, читает все данные до конца чанка. Байты возвращаются в виде строкового объекта. Пустая строка возвращается, если конец чанка встречен сразу.

#### `skip()`

Переходит к концу чанка. Все последующие вызовы

[`read()`](https://python-all.ru/3.1/library/chunk.html#chunk.Chunk.read)

для этого чанка будут возвращать

`''`

. Если содержимое чанка не нужно, следует вызвать этот метод, чтобы файл указывал на начало следующего чанка.

Сноски

| [\[1\]](https://python-all.ru/3.1/library/chunk.html#id1) | “EA IFF 85” – стандарт для файлов обменного формата, Jerry Morrison, Electronic Arts, январь 1985. |
| --- | --- |