Codec registry and support functions¶
-
int PyCodec_Register(PyObject *search_function)¶
- Część stabilnego ABI.
Register a new codec search function.
As side effect, this tries to load the
encodingspackage, if not yet done, to make sure that it is always first in the list of search functions.
-
int PyCodec_Unregister(PyObject *search_function)¶
- Część stabilnego ABI od wersji 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.
Dodane w wersji 3.10.
-
int PyCodec_KnownEncoding(const char *encoding)¶
- Część stabilnego ABI.
Return
1or0depending 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)¶
- Wartość zwracana: nowa referencja. Część stabilnego 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
NULLto use the default method defined for the codec. Raises aLookupErrorif no encoder can be found.
-
PyObject *PyCodec_Decode(PyObject *object, const char *encoding, const char *errors)¶
- Wartość zwracana: nowa referencja. Część stabilnego 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
NULLto use the default method defined for the codec. Raises aLookupErrorif 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 KeyError is set
and NULL returned.
-
PyObject *PyCodec_Encoder(const char *encoding)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get an encoder function for the given encoding.
-
PyObject *PyCodec_Decoder(const char *encoding)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get a decoder function for the given encoding.
-
PyObject *PyCodec_IncrementalEncoder(const char *encoding, const char *errors)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get an
IncrementalEncoderobject for the given encoding.
-
PyObject *PyCodec_IncrementalDecoder(const char *encoding, const char *errors)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get an
IncrementalDecoderobject for the given encoding.
-
PyObject *PyCodec_StreamReader(const char *encoding, PyObject *stream, const char *errors)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get a
StreamReaderfactory function for the given encoding.
-
PyObject *PyCodec_StreamWriter(const char *encoding, PyObject *stream, const char *errors)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Get a
StreamWriterfactory function for the given encoding.
Registry API for Unicode encoding error handlers¶
-
int PyCodec_RegisterError(const char *name, PyObject *error)¶
- Część stabilnego 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,UnicodeDecodeErrororUnicodeTranslateErrorthat 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
0on success,-1on error.
-
PyObject *PyCodec_LookupError(const char *name)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Lookup the error handling callback function registered under name. As a special case
NULLcan be passed, in which case the error handling callback for „strict” will be returned.
-
PyObject *PyCodec_StrictErrors(PyObject *exc)¶
- Wartość zwracana: zawsze NULL. Część stabilnego ABI.
Raise exc as an exception.
-
PyObject *PyCodec_IgnoreErrors(PyObject *exc)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Ignore the unicode error, skipping the faulty input.
-
PyObject *PyCodec_ReplaceErrors(PyObject *exc)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Replace the unicode encode error with
?orU+FFFD.
-
PyObject *PyCodec_XMLCharRefReplaceErrors(PyObject *exc)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Replace the unicode encode error with XML character references.
-
PyObject *PyCodec_BackslashReplaceErrors(PyObject *exc)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI.
Replace the unicode encode error with backslash escapes (
\x,\uand\U).
-
PyObject *PyCodec_NameReplaceErrors(PyObject *exc)¶
- Wartość zwracana: nowa referencja. Część stabilnego ABI od wersji 3.7.
Replace the unicode encode error with
\N{...}escapes.Dodane w wersji 3.5.