4.9.1.1 Codec オブジェクト

Codec クラスは以下のメソッドを定義します。これらのメソッドは、状態を保持しないエンコーダとデコーダ関数のインターフェイスを定義します。

encode( input[, errors])

オブジェクト input エンコードし、(出力オブジェクト, 消費した長さ) のタプルを返します。codecs は Unicode 専用ではありませんが、 Unicode の文脈では、エンコーディングは Unicode オブジェクトを、特定の文字集合エンコーディング（たとえば cp1252 や iso-8859-1）を使って文字列オブジェクトに変換します。

errors は適用するエラー処理を定義します。'strict' 処理がデフォルトです。

このメソッドは Codec の状態を保持しなくてかまいません。効率よくエンコード／デコードするために、状態を保持しなければならない codecs には StreamCodec を使いましょう。

エンコーダは長さが0の入力を受け付け、その場合には、空のオブジェクトを出力オブジェクトとして返す必要があります。

decode( input[, errors])

オブジェクト input をデコードし、(出力オブジェクト, 消費した長さ) のタプルを返します。Unicode の文脈では、デコードは特定の文字集合エンコーディングでエンコードされた文字列を Unicode オブジェクトに変換します。

input は bf_getreadbuf バッファスロットを提供するオブジェクトでなければいけません。Python 文字列オブジェクト、バッファオブジェクト、メモリにマップされたファイルが、バッファスロットの例です。

errors は適用するエラー処理を定義します。'strict' がデフォルト値です。

このメソッドは、Codec インスタンス内部の状態を保持しなくてもかまいません。効率よくエンコード／デコードするために、状態を保持しなければならない codecs には StreamCodec を使いましょう。

エンコーダは長さが0の入力を受け付け、その場合には、空のオブジェクトを出力オブジェクトとして返す必要があります。

StreamWriter と StreamReader クラスは、新しいエンコーディングモジュールを、非常に簡単に実装するのに使用できる、一般的なインターフェイス提供します。実装例は encodings.utf_8 をご覧ください。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。