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

---

# 22.5. [`chunk`](https://python-all.ru/3.3/library/chunk.html#module-chunk) – Чтение фрагментированных данных IFF

Этот модуль предоставляет интерфейс для чтения файлов, использующих EA IFF 85 чанки. [\[1\]](https://python-all.ru/3.3/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.3/library/chunk.html#chunk.Chunk), определённого здесь, заключается в создании экземпляра в начале каждого чанка и чтении из него до тех пор, пока он не закончится, после чего можно создать новый экземпляр. В конце файла создание нового экземпляра завершится исключением [`EOFError`](https://python-all.ru/3.3/library/exceptions.html#EOFError).

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

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

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

#### `getname()`

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

#### `getsize()`

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

#### `close()`

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

Остальные методы будут вызывать [`OSError`](https://python-all.ru/3.3/library/exceptions.html#OSError) при вызове после того, как был вызван метод [`close()`](https://python-all.ru/3.3/library/chunk.html#chunk.Chunk.close). До Python 3.3 они вызывали [`IOError`](https://python-all.ru/3.3/library/exceptions.html#IOError), который теперь является псевдонимом [`OSError`](https://python-all.ru/3.3/library/exceptions.html#OSError).

#### `isatty()`

Возвращает `False`.

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

Устанавливает текущую позицию в чанке. Аргумент *whence* необязателен и по умолчанию равен `0` (абсолютное позиционирование в файле); другие значения – `1` (относительно текущей позиции) и `2` (относительно конца файла). Возвращаемого значения нет. Если нижележащий файл не поддерживает позиционирование, разрешён только переход вперёд.

#### `tell()`

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

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

Читает не более *size* байт из чанка (меньше, если чтение достигает конца чанка до получения *size* байт). Если аргумент *size* отрицательный или опущен, читает все данные до конца чанка. Пустой объект bytes возвращается, если конец чанка встретился сразу.

#### `skip()`

Переход к концу чанка. Все последующие вызовы [`read()`](https://python-all.ru/3.3/library/chunk.html#chunk.Chunk.read) для этого чанка будут возвращать `b''`. Если содержимое чанка не интересует, этот метод следует вызывать, чтобы файл указывал на начало следующего чанка.

Сноски

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