Gecko [ www.foryou-vip.com ]

Name	Size	Permission	Date
abstract.rst	723 B	-rw-r--r--	2024-03-19 22:46
allocation.rst	2.64 KB	-rw-r--r--	2024-03-19 22:46
apiabiversion.rst	2.31 KB	-rw-r--r--	2024-03-19 22:46
arg.rst	30.91 KB	-rw-r--r--	2024-03-19 22:46
bool.rst	1.2 KB	-rw-r--r--	2024-03-19 22:46
buffer.rst	22.47 KB	-rw-r--r--	2024-03-19 22:46
bytearray.rst	2.2 KB	-rw-r--r--	2024-03-19 22:46
bytes.rst	9.24 KB	-rw-r--r--	2024-03-19 22:46
call.rst	16.56 KB	-rw-r--r--	2024-03-19 22:46
capsule.rst	5.68 KB	-rw-r--r--	2024-03-19 22:46
cell.rst	1.94 KB	-rw-r--r--	2024-03-19 22:46
code.rst	2.56 KB	-rw-r--r--	2024-03-19 22:46
codec.rst	5.01 KB	-rw-r--r--	2024-03-19 22:46
complex.rst	4.13 KB	-rw-r--r--	2024-03-19 22:46
concrete.rst	2.03 KB	-rw-r--r--	2024-03-19 22:46
contextvars.rst	4.11 KB	-rw-r--r--	2024-03-19 22:46
conversion.rst	5.39 KB	-rw-r--r--	2024-03-19 22:46
coro.rst	862 B	-rw-r--r--	2024-03-19 22:46
datetime.rst	8.46 KB	-rw-r--r--	2024-03-19 22:46
descriptor.rst	1.08 KB	-rw-r--r--	2024-03-19 22:46
dict.rst	8.51 KB	-rw-r--r--	2024-03-19 22:46
exceptions.rst	49.28 KB	-rw-r--r--	2024-03-19 22:46
file.rst	4.25 KB	-rw-r--r--	2024-03-19 22:46
float.rst	2.27 KB	-rw-r--r--	2024-03-19 22:46
function.rst	3.37 KB	-rw-r--r--	2024-03-19 22:46
gcsupport.rst	8.52 KB	-rw-r--r--	2024-03-19 22:46
gen.rst	1.35 KB	-rw-r--r--	2024-03-19 22:46
import.rst	12.61 KB	-rw-r--r--	2024-03-19 22:46
index.rst	632 B	-rw-r--r--	2024-03-19 22:46
init.rst	69.48 KB	-rw-r--r--	2024-03-19 22:46
init_config.rst	48.17 KB	-rw-r--r--	2024-03-19 22:46
intro.rst	32.23 KB	-rw-r--r--	2024-03-19 22:46
iter.rst	1.98 KB	-rw-r--r--	2024-03-19 22:46
iterator.rst	1.67 KB	-rw-r--r--	2024-03-19 22:46
list.rst	4.61 KB	-rw-r--r--	2024-03-19 22:46
long.rst	10.72 KB	-rw-r--r--	2024-03-19 22:46
mapping.rst	3.47 KB	-rw-r--r--	2024-03-19 22:46
marshal.rst	3.71 KB	-rw-r--r--	2024-03-19 22:46
memory.rst	29.92 KB	-rw-r--r--	2024-03-19 22:46
memoryview.rst	2.32 KB	-rw-r--r--	2024-03-19 22:46
method.rst	2.71 KB	-rw-r--r--	2024-03-19 22:46
module.rst	22.79 KB	-rw-r--r--	2024-03-19 22:46
none.rst	736 B	-rw-r--r--	2024-03-19 22:46
number.rst	10.83 KB	-rw-r--r--	2024-03-19 22:46
objbuffer.rst	2.39 KB	-rw-r--r--	2024-03-19 22:46
object.rst	15.16 KB	-rw-r--r--	2024-03-19 22:46
objimpl.rst	300 B	-rw-r--r--	2024-03-19 22:46
refcounting.rst	4.5 KB	-rw-r--r--	2024-03-19 22:46
reflection.rst	1.96 KB	-rw-r--r--	2024-03-19 22:46
sequence.rst	6.62 KB	-rw-r--r--	2024-03-19 22:46
set.rst	6.22 KB	-rw-r--r--	2024-03-19 22:46
slice.rst	4.47 KB	-rw-r--r--	2024-03-19 22:46
stable.rst	6.44 KB	-rw-r--r--	2024-03-19 22:46
structures.rst	18.59 KB	-rw-r--r--	2024-03-19 22:46
sys.rst	16.48 KB	-rw-r--r--	2024-03-19 22:46
tuple.rst	8.45 KB	-rw-r--r--	2024-03-19 22:46
type.rst	9.86 KB	-rw-r--r--	2024-03-19 22:46
typehints.rst	1.67 KB	-rw-r--r--	2024-03-19 22:46
typeobj.rst	127.01 KB	-rw-r--r--	2024-03-19 22:46
unicode.rst	67.9 KB	-rw-r--r--	2024-03-19 22:46
utilities.rst	410 B	-rw-r--r--	2024-03-19 22:46
veryhigh.rst	15.57 KB	-rw-r--r--	2024-03-19 22:46
weakref.rst	3.03 KB	-rw-r--r--	2024-03-19 22:46

Rename

.. _codec-registry:

Codec registry and support functions
====================================

.. c:function:: int PyCodec_Register(PyObject *search_function)

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

.. c:function:: int PyCodec_Unregister(PyObject *search_function)

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.

.. versionadded:: 3.10

.. c:function:: int PyCodec_KnownEncoding(const char *encoding)

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

.. c:function:: PyObject* PyCodec_Encode(PyObject *object, const char *encoding, const char *errors)

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
   :exc:`LookupError` if no encoder can be found.

.. c:function:: PyObject* PyCodec_Decode(PyObject *object, const char *encoding, const char *errors)

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
   :exc:`LookupError` if no encoder 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 :exc:`KeyError` is set
and ``NULL`` returned.

.. c:function:: PyObject* PyCodec_Encoder(const char *encoding)

Get an encoder function for the given *encoding*.

.. c:function:: PyObject* PyCodec_Decoder(const char *encoding)

Get a decoder function for the given *encoding*.

.. c:function:: PyObject* PyCodec_IncrementalEncoder(const char *encoding, const char *errors)

Get an :class:`~codecs.IncrementalEncoder` object for the given *encoding*.

.. c:function:: PyObject* PyCodec_IncrementalDecoder(const char *encoding, const char *errors)

Get an :class:`~codecs.IncrementalDecoder` object for the given *encoding*.

.. c:function:: PyObject* PyCodec_StreamReader(const char *encoding, PyObject *stream, const char *errors)

Get a :class:`~codecs.StreamReader` factory function for the given *encoding*.

.. c:function:: PyObject* PyCodec_StreamWriter(const char *encoding, PyObject *stream, const char *errors)

Get a :class:`~codecs.StreamWriter` factory function for the given *encoding*.

Registry API for Unicode encoding error handlers
------------------------------------------------

.. c:function:: int PyCodec_RegisterError(const char *name, PyObject *error)

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
   :exc:`UnicodeEncodeError`, :exc:`UnicodeDecodeError` or
   :exc:`UnicodeTranslateError` that holds information about the problematic
   sequence of characters or bytes and their offset in the original string (see
   :ref:`unicodeexceptions` 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.

.. c:function:: PyObject* PyCodec_LookupError(const char *name)

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.

.. c:function:: PyObject* PyCodec_StrictErrors(PyObject *exc)

Raise *exc* as an exception.

.. c:function:: PyObject* PyCodec_IgnoreErrors(PyObject *exc)

Ignore the unicode error, skipping the faulty input.

.. c:function:: PyObject* PyCodec_ReplaceErrors(PyObject *exc)

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

.. c:function:: PyObject* PyCodec_XMLCharRefReplaceErrors(PyObject *exc)

Replace the unicode encode error with XML character references.

.. c:function:: PyObject* PyCodec_BackslashReplaceErrors(PyObject *exc)

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

.. c:function:: PyObject* PyCodec_NameReplaceErrors(PyObject *exc)

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

.. versionadded:: 3.5