# Codec registry and support functions

int PyCodec_Register(PyObject *search_function)
  Часть Стабильный ABI.

  Register a new codec search function.

  As a side effect, this tries to load the `encodings` package, if not yet done, to make sure that it is always first in the list of search functions.

int PyCodec_Unregister(PyObject *search_function)
  Часть Стабильный ABI начиная с версии 3.10.

  Unregister a codec search function and clear the registry’s cache. If the search function is not registered, do nothing. Return 0 on success. Raise an exception and return -1 on error.

  Добавлено в версии 3.10.

int PyCodec_KnownEncoding(const char *encoding)
  Часть Стабильный ABI.

  Return `1` or `0` depending on whether there is a registered codec for the given encoding. This function always succeeds.

PyObject *PyCodec_Encode(PyObject *object, const char *encoding, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Generic codec based encoding API.

  object is passed through the encoder function found for the given encoding using the error handling method defined by errors. errors may be `NULL` to use the default method defined for the codec. Raises a `LookupError` if no encoder can be found.

PyObject *PyCodec_Decode(PyObject *object, const char *encoding, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Generic codec based decoding API.

  object is passed through the decoder function found for the given encoding using the error handling method defined by errors. errors may be `NULL` to use the default method defined for the codec. Raises a `LookupError` if no decoder can be found.

## Codec lookup API

In the following functions, the encoding string is looked up converted to all lower-case characters, which makes encodings looked up through this mechanism effectively case-insensitive. If no codec is found, a `KeyError` is set and `NULL` returned.

PyObject *PyCodec_Encoder(const char *encoding)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get an encoder function for the given encoding.

PyObject *PyCodec_Decoder(const char *encoding)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get a decoder function for the given encoding.

PyObject *PyCodec_IncrementalEncoder(const char *encoding, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get an `IncrementalEncoder` object for the given encoding.

PyObject *PyCodec_IncrementalDecoder(const char *encoding, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get an `IncrementalDecoder` object for the given encoding.

PyObject *PyCodec_StreamReader(const char *encoding, PyObject *stream, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get a `StreamReader` factory function for the given encoding.

PyObject *PyCodec_StreamWriter(const char *encoding, PyObject *stream, const char *errors)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Get a `StreamWriter` factory function for the given encoding.

## Registry API for Unicode encoding error handlers

int PyCodec_RegisterError(const char *name, PyObject *error)
  Часть Стабильный ABI.

  Register the error handling callback function error under the given name. This callback function will be called by a codec when it encounters unencodable characters/undecodable bytes and name is specified as the error parameter in the call to the encode/decode function.

  The callback gets a single argument, an instance of `UnicodeEncodeError`, `UnicodeDecodeError` or `UnicodeTranslateError` that holds information about the problematic sequence of characters or bytes and their offset in the original string (see Unicode Exception Objects for functions to extract this information). The callback must either raise the given exception, or return a two-item tuple containing the replacement for the problematic sequence, and an integer giving the offset in the original string at which encoding/decoding should be resumed.

  Return `0` on success, `-1` on error.

PyObject *PyCodec_LookupError(const char *name)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Lookup the error handling callback function registered under name. As a special case `NULL` can be passed, in which case the error handling callback for «strict» will be returned.

PyObject *PyCodec_StrictErrors(PyObject *exc)
  Возвращаемое значение: Всегда NULL. Часть Стабильный ABI.

  Raise exc as an exception.

PyObject *PyCodec_IgnoreErrors(PyObject *exc)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Ignore the unicode error, skipping the faulty input.

PyObject *PyCodec_ReplaceErrors(PyObject *exc)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Replace the unicode encode error with `?` or `U+FFFD`.

PyObject *PyCodec_XMLCharRefReplaceErrors(PyObject *exc)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Replace the unicode encode error with XML character references.

PyObject *PyCodec_BackslashReplaceErrors(PyObject *exc)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.

  Replace the unicode encode error with backslash escapes (`\x`, `\u` and `\U`).

PyObject *PyCodec_NameReplaceErrors(PyObject *exc)
  Возвращаемое значение: Новая ссылка. Часть Стабильный ABI начиная с версии 3.7.

  Replace the unicode encode error with `\N{...}` escapes.

  Добавлено в версии 3.5.

## Codec utility variables

const char *Py_hexdigits

  A string constant containing the lowercase hexadecimal digits: `"0123456789abcdef"`.

  Добавлено в версии 3.3.