codec レジストリとサポート関数¶
-
int
PyCodec_Register(PyObject *search_function)¶ 新しい codec 検索関数を登録します。
副作用として、この関数は
encodingsパッケージが常に検索関数の先頭に来るように、まだロードされていない場合はロードします。
-
int
PyCodec_KnownEncoding(const char *encoding)¶ Return
1or0depending on whether there is a registered codec for the given encoding.
-
PyObject*
PyCodec_Encode(PyObject *object, const char *encoding, const char *errors)¶ 汎用の codec ベースの encode API.
encoding に応じて見つかったエンコーダ関数に対して object を渡します。エラーハンドリングメソッドは errors で指定します。 errors は NULL でもよく、その場合はその codec のデフォルトのメソッドが利用されます。エンコーダが見つからなかった場合は
LookupErrorを発生させます。
-
PyObject*
PyCodec_Decode(PyObject *object, const char *encoding, const char *errors)¶ 汎用の codec ベースのデコード API.
encoding に応じて見つかったデコーダ関数に対して object を渡します。エラーハンドリングメソッドは errors で指定します。 errors は NULL でもよく、その場合はその codec のデフォルトのメソッドが利用されます。デコーダが見つからなかった場合は
LookupErrorを発生させます。
コーデック検索API¶
次の関数では、文字列 encoding は全て小文字に変換することで、効率的に、大文字小文字を無視した検索をします。コーデックが見つからない場合、 KeyError を設定して NULL を返します。
-
PyObject*
PyCodec_IncrementalEncoder(const char *encoding, const char *errors)¶ 与えられた encoding の
IncrementalEncoderオブジェクトを返します。
-
PyObject*
PyCodec_IncrementalDecoder(const char *encoding, const char *errors)¶ 与えられた encoding の
IncrementalDecoderオブジェクトを返します。
-
PyObject*
PyCodec_StreamReader(const char *encoding, PyObject *stream, const char *errors)¶ 与えられた encoding の
StreamReaderファクトリ関数を返します。
-
PyObject*
PyCodec_StreamWriter(const char *encoding, PyObject *stream, const char *errors)¶ 与えられた encoding の
StreamWriterファクトリ関数を返します。
Unicode エラーハンドラ用レジストリ API¶
-
int
PyCodec_RegisterError(const char *name, PyObject *error)¶ エラーハンドルのためのコールバック関数 error を name で登録します。このコールバック関数は、コーデックがエンコードできない文字/デコードできないバイトに遭遇した時に、そのエンコード/デコード関数の呼び出しで name が指定されていたら呼び出されます。
コールバックは1つの引数として、
UnicodeEncodeError,UnicodeDecodeError,UnicodeTranslateErrorのどれかのインスタンスを受け取ります。このインスタンスは問題のある文字列やバイト列に関する情報と、その元の文字列中のオフセットを持っています。(その情報を取得するための関数については Unicode 例外オブジェクト を参照してください。) コールバックは渡された例外を発生させるか、2要素のタプルに問題のシーケンスの代替と、 encode/decode を再開する元の文字列中のオフセットとなる整数を格納して返します。成功したら
0を、エラー時は-1を返します。
-
PyObject*
PyCodec_LookupError(const char *name)¶ name で登録されたエラーハンドリングコールバック関数を検索します。特別な場合として、NULL が渡された場合、"strict" のエラーハンドリングコールバック関数を返します。