データ整列化 (data marshalling) のサポート
******************************************

以下のルーチン群は、 "marshal" モジュールと同じ形式を使った整列化オブ
ジェクトを C コードから使えるようにします。整列化形式でデータを書き出
す関数に加えて、データを読み戻す関数もあります。整列化されたデータを記
録するファイルはバイナリモードで開かれていなければなりません。

数値は最小桁が先にくるように記録されます。

The module supports two versions of the data format: version 0 is the
historical version, version 1 shares interned strings in the file, and
upon unmarshalling.  Version 2 uses a binary format for floating point
numbers. "Py_MARSHAL_VERSION" indicates the current file format
(currently 2).

void PyMarshal_WriteLongToFile(long value, FILE *file, int version)

   long 型の整数値 *value* を *file* へ整列化します。この関数は
   *value* の下桁 32 ビットを書き込むだけです; ネイティブの long 型サ
   イズには関知しません。 *version* はファイルフォーマットを示します。

   この関数は失敗することがあり、その場合はエラー指示子を設定します。
   それを確認するために "PyErr_Occurred()" を使います。

void PyMarshal_WriteObjectToFile(PyObject *value, FILE *file, int version)

   Python オブジェクト *value* を *file* へ整列化します。*version* は
   ファイルフォーマットを示します。

   この関数は失敗することがあり、その場合はエラー指示子を設定します。
   それを確認するために "PyErr_Occurred()" を使います。

PyObject *PyMarshal_WriteObjectToString(PyObject *value, int version)
    *戻り値: 新しい参照。*

   *value* の整列化表現が入ったバイト列オブジェクトを返します。
   *version* はファイルフォーマットを示します。

以下の関数を使うと、整列化された値を読み戻せます。

long PyMarshal_ReadLongFromFile(FILE *file)

   読み出し用に開かれた FILE* 内のデータストリームから、 C の long 型
   データを読み出して返します。この関数は、ネイティブの long のサイズ
   に関係なく、 32 ビットの値だけを読み出せます。

   エラーの場合、適切な例外 ("EOFError") を設定し "-1" を返します。

int PyMarshal_ReadShortFromFile(FILE *file)

   読み出し用に開かれた FILE* 内のデータストリームから、 C の short 型
   データを読み出して返します。この関数は、ネイティブの short のサイズ
   に関係なく、 16 ビットの値だけを読み出せます。

   エラーの場合、適切な例外 ("EOFError") を設定し "-1" を返します。

PyObject *PyMarshal_ReadObjectFromFile(FILE *file)
    *戻り値: 新しい参照。*

   読み出し用に開かれた FILE* 内のデータストリームから Python オブジェ
   クトを返します。

   エラーの場合、適切な例外 ("EOFError", "ValueError", "TypeError") を
   設定し "NULL" を返します。

PyObject *PyMarshal_ReadLastObjectFromFile(FILE *file)
    *戻り値: 新しい参照。*

   読み出し用に開かれた FILE* 内のデータストリームから、 Python オブジ
   ェクトを読み出して返します。 "PyMarshal_ReadObjectFromFile()" と違
   い、この関数はファイル中に後続のオブジェクトが存在しないと仮定し、
   ファイルからメモリ上にファイルデータを一気にメモリにロードして、逆
   整列化機構がファイルから一バイトづつ読み出す代わりにメモリ上のデー
   タを操作できるようにします。対象のファイルから他に何も読み出さない
   と分かっている場合にのみ、この関数を使ってください。

   エラーの場合、適切な例外 ("EOFError", "ValueError", "TypeError") を
   設定し "NULL" を返します。

PyObject *PyMarshal_ReadObjectFromString(const char *data, Py_ssize_t len)
    *戻り値: 新しい参照。*

   *data* が指す *len* バイトのバイト列バッファ内のデータストリームか
   ら Python オブジェクトを返します。

   エラーの場合、適切な例外 ("EOFError", "ValueError", "TypeError") を
   設定し "NULL" を返します。
