> **Источник:** https://python-all.ru/3.16/c-api/codec.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Реестр кодеков и вспомогательные функции #### `int PyCodec_Register(PyObject *search_function)` *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Регистрирует новую функцию поиска кодека. Попутно эта функция пытается загрузить пакет `encodings`, если он ещё не загружен, чтобы он всегда был первым в списке функций поиска. #### `int PyCodec_Unregister(PyObject *search_function)` *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable) начиная с версии 3.10.* Отменяет регистрацию функции поиска кодека и очищает кеш реестра. Если функция не зарегистрирована, ничего не делает. Возвращает 0 при успехе. При ошибке возбуждает исключение и возвращает -1. Добавлено в версии 3.10. #### `int PyCodec_KnownEncoding(const char *encoding)` *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Возвращает `1` или `0` в зависимости от того, зарегистрирован ли кодек для заданной *encoding*. Эта функция всегда завершается успешно. #### `PyObject *PyCodec_Encode(PyObject *object, const char *encoding, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Универсальный API кодирования на основе кодеков. *object* передаётся в функцию кодировщика, найденную для заданной *encoding*, с использованием метода обработки ошибок, определённого в *errors*. Значение *errors* может быть `NULL` для использования метода по умолчанию, определённого для кодека. Возбуждает [`LookupError`](https://python-all.ru/3.16/library/exceptions.html#LookupError), если кодировщик не найден. #### `PyObject *PyCodec_Decode(PyObject *object, const char *encoding, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Универсальный API декодирования на основе кодеков. *object* передаётся в функцию декодера, найденную для заданной *encoding*, с использованием метода обработки ошибок, определённого в *errors*. Значение *errors* может быть `NULL` для использования метода по умолчанию, определённого для кодека. Возбуждает [`LookupError`](https://python-all.ru/3.16/library/exceptions.html#LookupError), если декодер не найден. ## API для поиска кодеков В следующих функциях строка *encoding* при поиске приводится к нижнему регистру, что делает поиск кодировок через этот механизм нечувствительным к регистру. Если кодек не найден, устанавливается [`KeyError`](https://python-all.ru/3.16/library/exceptions.html#KeyError) и возвращается `NULL`. #### `PyObject *PyCodec_Encoder(const char *encoding)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Возвращает функцию кодировщика для заданной *encoding*. #### `PyObject *PyCodec_Decoder(const char *encoding)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Возвращает функцию декодера для заданной *encoding*. #### `PyObject *PyCodec_IncrementalEncoder(const char *encoding, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Получить объект [`IncrementalEncoder`](https://python-all.ru/3.16/library/codecs.html#codecs.IncrementalEncoder) для указанной *кодировки*. #### `PyObject *PyCodec_IncrementalDecoder(const char *encoding, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Получить объект [`IncrementalDecoder`](https://python-all.ru/3.16/library/codecs.html#codecs.IncrementalDecoder) для указанной *кодировки*. #### `PyObject *PyCodec_StreamReader(const char *encoding, PyObject *stream, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Получить [`StreamReader`](https://python-all.ru/3.16/library/codecs.html#codecs.StreamReader) фабричную функцию для указанной *кодировки*. #### `PyObject *PyCodec_StreamWriter(const char *encoding, PyObject *stream, const char *errors)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Получить [`StreamWriter`](https://python-all.ru/3.16/library/codecs.html#codecs.StreamWriter) фабричную функцию для указанной *кодировки*. ## API реестра обработчиков ошибок кодирования Unicode #### `int PyCodec_RegisterError(const char *name, PyObject *error)` *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Зарегистрировать колбэк-функцию обработки ошибок *error* под указанным именем *name*. Эта колбэк-функция будет вызвана кодеком, когда он встретит некодируемые символы/недекодируемые байты, и *name* указан в качестве параметра error в вызове функции encode/decode. Колбэк получает один аргумент – экземпляр [`UnicodeEncodeError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeEncodeError), [`UnicodeDecodeError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeDecodeError) или [`UnicodeTranslateError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeTranslateError), который содержит информацию о проблемной последовательности символов или байтов и их смещении в исходной строке (см. [Объекты исключений Unicode](https://python-all.ru/3.16/c-api/exceptions.html#unicodeexceptions) для функций извлечения этой информации). Колбэк должен либо вызвать полученное исключение, либо вернуть кортеж из двух элементов, содержащий замену для проблемной последовательности и целое число, указывающее смещение в исходной строке, с которого следует продолжить кодирование/декодирование. Возвращает `0` в случае успеха, `-1` при ошибке. #### `PyObject *PyCodec_LookupError(const char *name)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Найти колбэк-функцию обработки ошибок, зарегистрированную под именем *name*. В частном случае можно передать `NULL`, и тогда будет возвращён колбэк обработки ошибок для «strict». #### `PyObject *PyCodec_StrictErrors(PyObject *exc)` *Возвращаемое значение: всегда NULL.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Возбудить *exc* как исключение. #### `PyObject *PyCodec_IgnoreErrors(PyObject *exc)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Игнорировать ошибку Unicode, пропуская некорректный ввод. #### `PyObject *PyCodec_ReplaceErrors(PyObject *exc)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Заменить ошибку кодирования Unicode на `?` или `U+FFFD`. #### `PyObject *PyCodec_XMLCharRefReplaceErrors(PyObject *exc)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Заменить ошибку кодирования Unicode на символьные ссылки XML. #### `PyObject *PyCodec_BackslashReplaceErrors(PyObject *exc)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable).* Заменить ошибку кодирования Юникод на escape-последовательности с обратной косой чертой (`\x`, `\u` и `\U`). #### `PyObject *PyCodec_NameReplaceErrors(PyObject *exc)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.16/c-api/stable.html#stable) начиная с версии 3.7.* Заменить ошибку кодирования Юникод на escape-последовательности `\N{...}`. Добавлено в версии 3.5. ## Вспомогательные переменные кодека #### `const char *Py_hexdigits` Строковая константа, содержащая строчные шестнадцатеричные цифры: `"0123456789abcdef"`. Добавлено в версии 3.3.