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.

   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)
    * 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.

   Added in version 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* 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.


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{...}".

   Added in version 3.5.


Codec utility variables
=======================

const char *Py_hexdigits

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

   Added in version 3.3.
