古いバッファプロトコル
**********************

This section describes the legacy buffer protocol, which has been
introduced in Python 1.6. It is still supported but deprecated in the
Python 2.x series. Python 3 introduces a new buffer protocol which
fixes weaknesses and shortcomings of the protocol, and has been
backported to Python 2.6.  See Buffers and Memoryview Objects for more
information.

int PyObject_AsCharBuffer(PyObject *obj, const char **buffer, Py_ssize_t *buffer_len)

   文字ベースの入力として使える読み出し専用メモリ上の位置へのポインタ
   を返します。 *obj* 引数は単一セグメントからなる文字バッファインタフ
   ェースをサポートしていなければなりません。成功すると "0" を返し、
   *buffer* をメモリの位置に、  *buffer_len* をバッファの長さに設定し
   ます。エラーの際には  "-1" を返し、 "TypeError" をセットします。

   バージョン 1.6 で追加.

   バージョン 2.5 で変更: This function used an "int *" type for
   *buffer_len*. This might require changes in your code for properly
   supporting 64-bit systems.

int PyObject_AsReadBuffer(PyObject *obj, const void **buffer, Py_ssize_t *buffer_len)

   任意のデータを収めた読み出し専用のメモリ上の位置へのポインタを返し
   ます。 *obj* 引数は単一セグメントからなる読み出し可能バッファインタ
   フェースをサポートしていなければなりません。成功すると "0" を返し、
   *buffer* をメモリの位置に、  *buffer_len* をバッファの長さに設定し
   ます。エラーの際には  "-1" を返し、 "TypeError" をセットします。

   バージョン 1.6 で追加.

   バージョン 2.5 で変更: This function used an "int *" type for
   *buffer_len*. This might require changes in your code for properly
   supporting 64-bit systems.

int PyObject_CheckReadBuffer(PyObject *o)

   *o* が単一セグメントからなる読み出し可能バッファインタフェースをサ
   ポートしている場合に "1" を返します。それ以外の場合には "0" を返し
   ます。

   バージョン 2.2 で追加.

int PyObject_AsWriteBuffer(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)

   Returns a pointer to a writeable memory location.  The *obj*
   argument must support the single-segment, character buffer
   interface.  On success, returns "0", sets *buffer* to the memory
   location and *buffer_len* to the buffer length.  Returns "-1" and
   sets a "TypeError" on error.

   バージョン 1.6 で追加.

   バージョン 2.5 で変更: This function used an "int *" type for
   *buffer_len*. This might require changes in your code for properly
   supporting 64-bit systems.
