编解码器注册和支持函数 ¶

int PyCodec_Register ( PyObject * search_function ) ¶

属于稳定 ABI (应用程序二进制接口) .

Register a new codec search function.

As 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 (应用程序二进制接口) since version 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 (应用程序二进制接口) .
返回 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 可以是 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 可以是 NULL to use the default method defined for the codec. Raises a LookupError if no encoder can be found.

编解码器查找 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 被返回。

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 对象为给定 encoding .

PyObject * PyCodec_IncrementalDecoder ( const char * encoding , const char * errors ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Get an IncrementalDecoder 对象为给定 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 .

为 Unicode 编码错误处理程序注册 API ¶

int PyCodec_RegisterError ( const char * 名称 , 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 异常对象 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.

返回 0 当成功时， -1 当出错时。

PyObject * PyCodec_LookupError ( const char * 名称 ) ¶: 返回值：新引用。 属于稳定 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 (应用程序二进制接口) .
引发 exc 作为异常。

PyObject * PyCodec_IgnoreErrors ( PyObject * exc ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Ignore the unicode error, skipping the faulty input.

PyObject * PyCodec_ReplaceErrors ( PyObject * exc ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
替换 Unicode 编码错误采用 ? 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 (应用程序二进制接口) since version 3.7.

替换 Unicode 编码错误采用 \N{...} 转义。

Added in version 3.5.

内容表

编解码器注册和支持函数
- 编解码器查找 API
- 为 Unicode 编码错误处理程序注册 API

上一话题

下一话题

本页

«