aifc.md

1> **Источник:** https://python-all.ru/3.5/library/aifc.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 22.2. [`aifc`](https://python-all.ru/3.5/library/aifc.html#module-aifc) – Чтение и запись файлов AIFF и AIFC89**Исходный код:** [Lib/aifc.py](https://python-all.ru/src/3.5/Lib/aifc.py)1011---1213Этот модуль обеспечивает поддержку чтения и записи файлов AIFF и AIFF-C. AIFF – это формат Audio Interchange File Format, предназначенный для хранения цифровых аудио сэмплов в файле. AIFF-C – более новая версия формата, включающая возможность сжатия аудиоданных.1415> **Примечание**16>17> Некоторые операции могут работать только под IRIX; они вызовут [`ImportError`](https://python-all.ru/3.5/library/exceptions.html#ImportError) при попытке импорта модуля `cl`, который доступен только на IRIX.1819Аудиофайлы имеют ряд параметров, описывающих аудиоданные. Частота дискретизации (или частота кадров) – это количество раз в секунду, которое звук дискретизируется. Количество каналов указывает, является ли аудио моно, стерео или квадро. Каждый кадр состоит из одного сэмпла на канал. Размер сэмпла – это размер в байтах каждого сэмпла. Таким образом, кадр состоит из `nchannels * samplesize` байт, а секунда аудио занимает `nchannels * samplesize * framerate` байт.2021Например, аудио CD-качества имеет размер сэмпла два байта (16 бит), использует два канала (стерео) и имеет частоту кадров 44 100 кадров/сек. Это даёт размер кадра 4 байта (2\*2), а одна секунда аудио занимает 2\*2\*44100 байт (176 400 байт).2223Модуль [`aifc`](https://python-all.ru/3.5/library/aifc.html#module-aifc) определяет следующую функцию:2425#### `aifc.open(file, mode=None)`2627Открывает файл AIFF или AIFF-C и возвращает экземпляр объекта с методами, которые описаны ниже. Аргумент *file* – это либо строка с именем файла, либо [файловый объект](https://python-all.ru/3.5/glossary.html#term-file-object). *mode* должен быть `'r'` или `'rb'`, если файл открывается для чтения, или `'w'` или `'wb'`, если файл открывается для записи. Если не указан, используется `file.mode` (если файл существует), иначе `'rb'`. При использовании для записи файловый объект должен поддерживать позиционирование, если заранее не известно общее количество сэмплов и не используются `writeframesraw()` и `setnframes()`. Функция [`open()`](https://python-all.ru/3.5/library/aifc.html#aifc.open) может использоваться в операторе [`with`](https://python-all.ru/3.5/reference/compound_stmts.html#with). После завершения блока [`with`](https://python-all.ru/3.5/reference/compound_stmts.html#with) вызывается метод [`close()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.close).2829Изменено в версии 3.4: Добавлена поддержка оператора [`with`](https://python-all.ru/3.5/reference/compound_stmts.html#with).3031Объекты, возвращаемые [`open()`](https://python-all.ru/3.5/library/aifc.html#aifc.open) при открытии файла для чтения, имеют следующие методы:3233#### `aifc.getnchannels()`3435Возвращает количество аудиоканалов (1 для моно, 2 для стерео).3637#### `aifc.getsampwidth()`3839Возвращает размер отдельных сэмплов в байтах.4041#### `aifc.getframerate()`4243Возвращает частоту дискретизации (количество аудиокадров в секунду).4445#### `aifc.getnframes()`4647Возвращает количество аудиокадров в файле.4849#### `aifc.getcomptype()`5051Возвращает массив байтов длиной 4, описывающий тип сжатия, используемый в аудиофайле. Для файлов AIFF возвращаемое значение – `b'NONE'`.5253#### `aifc.getcompname()`5455Возвращает массив байтов, преобразуемый в читаемое человеком описание типа сжатия, используемого в аудиофайле. Для файлов AIFF возвращаемое значение – `b'not compressed'`.5657#### `aifc.getparams()`5859Возвращает [`namedtuple()`](https://python-all.ru/3.5/library/collections.html#collections.namedtuple) `(nchannels, sampwidth, framerate, nframes, comptype, compname)`, эквивалентный результату методов `get*()`.6061#### `aifc.getmarkers()`6263Возвращает список маркеров в аудиофайле. Маркер состоит из кортежа из трёх элементов. Первый – идентификатор маркера (целое число), второй – позиция маркера в кадрах от начала данных (целое число), третий – имя маркера (строка).6465#### `aifc.getmark(id)`6667Возвращает кортеж, как описано в [`getmarkers()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.getmarkers), для маркера с заданным *id*.6869#### `aifc.readframes(nframes)`7071Читает и возвращает следующие *nframes* кадров из аудиофайла. Возвращаемые данные – это строка, содержащая для каждого кадра несжатые сэмплы всех каналов.7273#### `aifc.rewind()`7475Перематывает указатель чтения. Следующий вызов [`readframes()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.readframes) начнётся с начала.7677#### `aifc.setpos(pos)`7879Перейти к указанному номеру кадра.8081#### `aifc.tell()`8283Возвращает текущий номер кадра.8485#### `aifc.close()`8687Закрывает файл AIFF. После вызова этого метода объект больше нельзя использовать.8889Объекты, возвращаемые [`open()`](https://python-all.ru/3.5/library/aifc.html#aifc.open) при открытии файла для записи, имеют все перечисленные выше методы, за исключением `readframes()` и `setpos()`. Кроме того, существуют следующие методы. Методы `get*()` можно вызывать только после вызова соответствующих методов `set*()`. До первого `writeframes()` или `writeframesraw()` должны быть заданы все параметры, кроме количества кадров.9091#### `aifc.aiff()`9293Создаёт файл AIFF. По умолчанию создаётся файл AIFF-C, если только имя файла не заканчивается на `'.aiff'`, – в этом случае по умолчанию создаётся файл AIFF.9495#### `aifc.aifc()`9697Создаёт файл AIFF-C. По умолчанию создаётся файл AIFF-C, если только имя файла не заканчивается на `'.aiff'`, – в этом случае по умолчанию создаётся файл AIFF.9899#### `aifc.setnchannels(nchannels)`100101Задаёт количество каналов в аудиофайле.102103#### `aifc.setsampwidth(width)`104105Задаёт размер аудиосэмплов в байтах.106107#### `aifc.setframerate(rate)`108109Задаёт частоту дискретизации в кадрах в секунду.110111#### `aifc.setnframes(nframes)`112113Задаёт количество кадров, которые будут записаны в аудиофайл. Если этот параметр не задан или задан неверно, файл должен поддерживать перемещение (seeking).114115#### `aifc.setcomptype(type, name)`116117Задаёт тип сжатия. Если не указан, аудиоданные не сжимаются. В файлах AIFF сжатие невозможно. Параметр name должен быть человекопонятным описанием типа сжатия в виде массива байтов, параметр type должен быть массивом байтов длиной 4. В настоящее время поддерживаются следующие типы сжатия: `b'NONE'`, `b'ULAW'`, `b'ALAW'`, `b'G722'`.118119#### `aifc.setparams(nchannels, sampwidth, framerate, comptype, compname)`120121Устанавливает все перечисленные выше параметры за один раз. Аргументом является кортеж, состоящий из различных параметров. Это означает, что результат вызова [`getparams()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.getparams) можно использовать в качестве аргумента для [`setparams()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.setparams).122123#### `aifc.setmark(id, pos, name)`124125Добавляет метку с заданным id (больше 0) и заданным именем в указанной позиции. Этот метод можно вызывать в любое время до [`close()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.close).126127#### `aifc.tell()`128129Возвращает текущую позицию записи в выходном файле. Полезно в сочетании с [`setmark()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.setmark).130131#### `aifc.writeframes(data)`132133Записывает данные в выходной файл. Этот метод можно вызывать только после того, как параметры аудиофайла были заданы.134135Изменено в версии 3.4: Теперь принимается любой [байтоподобный объект](https://python-all.ru/3.5/glossary.html#term-bytes-like-object).136137#### `aifc.writeframesraw(data)`138139Как [`writeframes()`](https://python-all.ru/3.5/library/aifc.html#aifc.aifc.writeframes), за исключением того, что заголовок аудиофайла не обновляется.140141Изменено в версии 3.4: Теперь принимается любой [байтоподобный объект](https://python-all.ru/3.5/glossary.html#term-bytes-like-object).142143#### `aifc.close()`144145Закрывает AIFF-файл. Заголовок файла обновляется, чтобы отражать фактический размер аудиоданных. После вызова этого метода объект больше нельзя использовать.146