# Registro de códec y funciones de soporte

int `PyCodec_Register`(PyObject *search_function)
  Part of the Stable ABI.

  Registra una nueva función de búsqueda de códec.

  Como efecto secundario, intenta cargar el paquete `encodings`, si aún no lo ha hecho, para asegurarse de que siempre esté primero en la lista de funciones de búsqueda.

int `PyCodec_Unregister`(PyObject *search_function)
  Part of the Stable ABI since version 3.10.

  Anula el registro de una función de búsqueda de códecs y borra el caché del registro. Si la función de búsqueda no está registrada, no hace nada. Retorna 0 en caso de éxito. Lanza una excepción y devuelva -1 en caso de error.

  Nuevo en la versión 3.10.

int `PyCodec_KnownEncoding`(const char *encoding)
  Part of the Stable ABI.

  Retorna `1` o `0` dependiendo de si hay un códec registrado para el encoding dado. Esta función siempre finaliza con éxito.

PyObject *`PyCodec_Encode`(PyObject *object, const char *encoding, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  API de codificación genérica basada en códec.

  object se pasa a través de la función de codificador encontrada por el encoding dado usando el método de manejo de errores definido por errors. errors pueden ser `NULL` para usar el método predeterminado definido para el códec. Lanza un `LookupError` si no se puede encontrar el codificador.

PyObject *`PyCodec_Decode`(PyObject *object, const char *encoding, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  API de decodificación basada en códec genérico.

  object se pasa a través de la función de decodificador encontrada por el encoding dado usando el método de manejo de errores definido por errors. errors puede ser `NULL` para usar el método predeterminado definido para el códec. Lanza un `LookupError` si no se puede encontrar el codificador.

## API de búsqueda de códec

En las siguientes funciones, la cadena de caracteres encoding se busca convertida a todos los caracteres en minúscula, lo que hace que las codificaciones se busquen a través de este mecanismo sin distinción entre mayúsculas y minúsculas. Si no se encuentra ningún códec, se establece un `KeyError` y se retorna `NULL`.

PyObject *`PyCodec_Encoder`(const char *encoding)
  Return value: New reference. Part of the Stable ABI.

  Obtiene una función de codificador para el encoding dado.

PyObject *`PyCodec_Decoder`(const char *encoding)
  Return value: New reference. Part of the Stable ABI.

  Obtiene una función de decodificador para el encoding dado.

PyObject *`PyCodec_IncrementalEncoder`(const char *encoding, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  Obtiene un objeto `IncrementalEncoder` para el encoding dada.

PyObject *`PyCodec_IncrementalDecoder`(const char *encoding, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  Obtiene un objeto `IncrementalDecoder` para el encoding dado.

PyObject *`PyCodec_StreamReader`(const char *encoding, PyObject *stream, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  Obtiene una función de fábrica `StreamReader` para el encoding dado.

PyObject *`PyCodec_StreamWriter`(const char *encoding, PyObject *stream, const char *errors)
  Return value: New reference. Part of the Stable ABI.

  Obtiene una función de fábrica `StreamWriter` por el encoding dado.

## API de registro para controladores de errores de codificación Unicode

int `PyCodec_RegisterError`(const char *name, PyObject *error)
  Part of the Stable ABI.

  Registra la función de devolución de llamada de manejo de errores error bajo el nombre name dado. Esta función de devolución de llamada será llamada por un códec cuando encuentre caracteres no codificables / bytes no codificables y name se especifica como parámetro de error en la llamada a la función de codificación / decodificación.

  La devolución de llamada obtiene un único argumento, una instancia de `UnicodeEncodeError`, `UnicodeDecodeError` o `UnicodeTranslateError` que contiene información sobre la secuencia problemática de caracteres o bytes y su desplazamiento en la cadena original (consulte Objetos Unicode de Excepción para funciones para extraer esta información). La devolución de llamada debe lanzar la excepción dada o retornar una tupla de dos elementos que contiene el reemplazo de la secuencia problemática, y un número entero que proporciona el desplazamiento en la cadena original en la que se debe reanudar la codificación / decodificación.

  Retorna `0` en caso de éxito, `-1` en caso de error.

PyObject *`PyCodec_LookupError`(const char *name)
  Return value: New reference. Part of the Stable ABI.

  Busca la función de devolución de llamada de manejo de errores registrada con name. Como caso especial se puede pasar `NULL`, en cuyo caso se retornará la devolución de llamada de manejo de errores para «estricto».

PyObject *`PyCodec_StrictErrors`(PyObject *exc)
  Return value: Always NULL. Part of the Stable ABI.

  Lanza exc como una excepción.

PyObject *`PyCodec_IgnoreErrors`(PyObject *exc)
  Return value: New reference. Part of the Stable ABI.

  Ignora el error Unicode, omitiendo la entrada defectuosa.

PyObject *`PyCodec_ReplaceErrors`(PyObject *exc)
  Return value: New reference. Part of the Stable ABI.

  Reemplaza el error de codificación Unicode con `?` o `U+FFFD`.

PyObject *`PyCodec_XMLCharRefReplaceErrors`(PyObject *exc)
  Return value: New reference. Part of the Stable ABI.

  Reemplaza el error de codificación Unicode con referencias de caracteres XML.

PyObject *`PyCodec_BackslashReplaceErrors`(PyObject *exc)
  Return value: New reference. Part of the Stable ABI.

  Reemplaza el error de codificación Unicode con escapes de barra invertida (`\x`, `\u` y `\U`).

PyObject *`PyCodec_NameReplaceErrors`(PyObject *exc)
  Return value: New reference. Part of the Stable ABI since version 3.7.

  Reemplaza el error de codificación Unicode con escapes `\N{...}`.

  Nuevo en la versión 3.5.