> **Источник:** https://python-all.ru/3.4/library/aifc.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 22.2. [`aifc`](https://python-all.ru/3.4/library/aifc.html#module-aifc) – Чтение и запись AIFF и AIFC файлов **Исходный код:** [Lib/aifc.py](https://python-all.ru/src/3.4/Lib/aifc.py) --- Этот модуль обеспечивает поддержку чтения и записи файлов AIFF и AIFF-C. AIFF – это формат Audio Interchange File Format, предназначенный для хранения цифровых аудио сэмплов в файле. AIFF-C – более новая версия формата, включающая возможность сжатия аудиоданных. > **Примечание** > > Some operations may only work under IRIX; these will raise [`ImportError`](https://python-all.ru/3.4/library/exceptions.html#ImportError) when attempting to import the `cl` module, which is only available on IRIX. Аудиофайлы имеют ряд параметров, описывающих звуковые данные. Частота дискретизации, или частота кадров, – это количество отсчётов звука в секунду. Число каналов определяет, является ли аудио моно, стерео или четырёхканальным. Каждый кадр состоит из одного отсчёта на канал. Размер отсчёта – это размер в байтах каждого отсчёта. Таким образом, кадр состоит из `nchannels * samplesize` байт, а секунда аудио – из `nchannels * samplesize * framerate` байт. Например, аудио CD-качества имеет размер сэмпла два байта (16 бит), использует два канала (стерео) и имеет частоту кадров 44 100 кадров/сек. Это даёт размер кадра 4 байта (2\*2), а одна секунда аудио занимает 2\*2\*44100 байт (176 400 байт). Модуль [`aifc`](https://python-all.ru/3.4/library/aifc.html#module-aifc) определяет следующую функцию: #### `aifc.open(file, mode=None)` Открывает AIFF- или AIFF-C-файл и возвращает объект с методами, описанными ниже. Аргумент *file* – это либо строка с именем файла, либо [*файловый объект*](https://python-all.ru/3.4/glossary.html#term-file-object). *mode* должен быть равен `'r'` или `'rb'`, если файл открывается для чтения, или `'w'` или `'wb'`, если файл открывается для записи. Если этот аргумент опущен, используется `file.mode` (если он существует), в противном случае – `'rb'`. При записи файловый объект должен поддерживать позиционирование, если только заранее не известно точное количество отсчётов, которые будут записаны, и не используются `writeframesraw()` и `setnframes()`. Функция [`open()`](https://python-all.ru/3.4/library/aifc.html#aifc.open) может использоваться в выражении [`with`](https://python-all.ru/3.4/reference/compound_stmts.html#with). Когда блок [`with`](https://python-all.ru/3.4/reference/compound_stmts.html#with) завершается, вызывается метод [`close()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.close). Изменено в версии 3.4: Добавлена поддержка оператора [`with`](https://python-all.ru/3.4/reference/compound_stmts.html#with). Объекты, возвращаемые [`open()`](https://python-all.ru/3.4/library/aifc.html#aifc.open) при открытии файла для чтения, имеют следующие методы: #### `aifc.getnchannels()` Возвращает количество аудиоканалов (1 для моно, 2 для стерео). #### `aifc.getsampwidth()` Возвращает размер отдельных сэмплов в байтах. #### `aifc.getframerate()` Возвращает частоту дискретизации (количество аудиокадров в секунду). #### `aifc.getnframes()` Возвращает количество аудиокадров в файле. #### `aifc.getcomptype()` Возвращает массив байтов длиной 4, описывающий тип сжатия, используемый в аудиофайле. Для AIFF-файлов возвращается значение `b'NONE'`. #### `aifc.getcompname()` Возвращает массив байтов, преобразуемый в удобочитаемое описание типа сжатия, используемого в аудиофайле. Для AIFF-файлов возвращается значение `b'not compressed'`. #### `aifc.getparams()` Возвращает [`namedtuple()`](https://python-all.ru/3.4/library/collections.html#collections.namedtuple) `(nchannels, sampwidth, framerate, nframes, comptype, compname)`, что эквивалентно результату методов `get*()`. #### `aifc.getmarkers()` Возвращает список маркеров в аудиофайле. Маркер состоит из кортежа из трёх элементов. Первый – идентификатор маркера (целое число), второй – позиция маркера в кадрах от начала данных (целое число), третий – имя маркера (строка). #### `aifc.getmark(id)` Возвращает кортеж, как описано в [`getmarkers()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.getmarkers), для маркера с заданным *id*. #### `aifc.readframes(nframes)` Читает и возвращает следующие *nframes* кадров из аудиофайла. Возвращаемые данные – это строка, содержащая для каждого кадра несжатые сэмплы всех каналов. #### `aifc.rewind()` Перематывает указатель чтения. Следующий вызов [`readframes()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.readframes) начнётся с начала. #### `aifc.setpos(pos)` Перейти к указанному номеру кадра. #### `aifc.tell()` Возвращает текущий номер кадра. #### `aifc.close()` Закрывает файл AIFF. После вызова этого метода объект больше нельзя использовать. Объекты, возвращаемые [`open()`](https://python-all.ru/3.4/library/aifc.html#aifc.open) при открытии файла для записи, имеют все перечисленные выше методы, кроме `readframes()` и `setpos()`. Кроме того, существуют следующие методы. Методы `get*()` можно вызывать только после того, как соответствующие методы `set*()` были вызваны. Перед первым вызовом `writeframes()` или `writeframesraw()` должны быть заданы все параметры, кроме количества кадров. #### `aifc.aiff()` Создаёт AIFF-файл. По умолчанию создаётся файл AIFF-C, если только имя файла не заканчивается на `'.aiff'` – в этом случае по умолчанию создаётся AIFF-файл. #### `aifc.aifc()` Создаёт файл AIFF-C. По умолчанию создаётся файл AIFF-C, если только имя файла не заканчивается на `'.aiff'`; в этом случае по умолчанию создаётся файл AIFF. #### `aifc.setnchannels(nchannels)` Задаёт количество каналов в аудиофайле. #### `aifc.setsampwidth(width)` Задаёт размер аудиосэмплов в байтах. #### `aifc.setframerate(rate)` Задаёт частоту дискретизации в кадрах в секунду. #### `aifc.setnframes(nframes)` Задаёт количество кадров, которые будут записаны в аудиофайл. Если этот параметр не задан или задан неверно, файл должен поддерживать перемещение (seeking). #### `aifc.setcomptype(type, name)` Задаёт тип сжатия. Если тип не указан, аудиоданные не сжимаются. В файлах AIFF сжатие невозможно. Параметр name должен быть человекочитаемым описанием типа сжатия в виде массива байтов, параметр type должен быть массивом байтов длиной 4. В настоящее время поддерживаются следующие типы сжатия: `b'NONE'`, `b'ULAW'`, `b'ALAW'`, `b'G722'`. #### `aifc.setparams(nchannels, sampwidth, framerate, comptype, compname)` Устанавливает все перечисленные выше параметры сразу. Аргументом является кортеж, состоящий из различных параметров. Это означает, что результат вызова [`getparams()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.getparams) можно использовать как аргумент для [`setparams()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.setparams). #### `aifc.setmark(id, pos, name)` Добавляет метку с заданным id (больше 0) и заданным именем в заданной позиции. Этот метод можно вызывать в любое время до [`close()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.close). #### `aifc.tell()` Возвращает текущую позицию записи в выходном файле. Полезно в сочетании с [`setmark()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.setmark). #### `aifc.writeframes(data)` Записывает данные в выходной файл. Этот метод можно вызывать только после того, как параметры аудиофайла были заданы. Изменено в версии 3.4: Теперь принимается любой [*байтоподобный объект*](https://python-all.ru/3.4/glossary.html#term-bytes-like-object). #### `aifc.writeframesraw(data)` Аналогично [`writeframes()`](https://python-all.ru/3.4/library/aifc.html#aifc.aifc.writeframes), за исключением того, что заголовок аудиофайла не обновляется. Изменено в версии 3.4: Теперь принимается любой [*байтоподобный объект*](https://python-all.ru/3.4/glossary.html#term-bytes-like-object). #### `aifc.close()` Закрывает AIFF-файл. Заголовок файла обновляется, чтобы отражать фактический размер аудиоданных. После вызова этого метода объект больше нельзя использовать.