セルオブジェクト (cell object)
******************************

"Cell" objects are used to implement variables referenced by multiple
scopes. For each such variable, a cell object is created to store the
value; the local variables of each stack frame that references the
value contain a reference to the cells from outer scopes which also
use that variable.  When the value is accessed, the value contained in
the cell is used instead of the cell object itself.  This de-
referencing of the cell object requires support from the generated
byte-code; these are not automatically de-referenced when accessed.
Cell objects are not likely to be useful elsewhere.

type PyCellObject

   セルオブジェクトに使われる C 構造体です。

PyTypeObject PyCell_Type

   セルオブジェクトに対応する型オブジェクトです。

int PyCell_Check(PyObject *ob)

   *ob* がセルオブジェクトの場合に真を返します; *ob* は "NULL" であっ
   てはなりません。この関数は常に成功します。

PyObject *PyCell_New(PyObject *ob)
    *戻り値: 新しい参照。*

   値 *ob* の入った新たなセルオブジェクトを生成して返します。 引数を
   "NULL" にしてもかまいません。

PyObject *PyCell_Get(PyObject *cell)
    *戻り値: 新しい参照。*

   Return the contents of the cell *cell*, which can be "NULL". If
   *cell* is not a cell object, returns "NULL" with an exception set.

PyObject *PyCell_GET(PyObject *cell)
    *戻り値: 借用参照。*

   *cell* の内容を返しますが、*cell* が非 "NULL" かつセルオブジェクト
   であるかどうかはチェックしません。

int PyCell_Set(PyObject *cell, PyObject *value)

   Set the contents of the cell object *cell* to *value*.  This
   releases the reference to any current content of the cell. *value*
   may be "NULL".  *cell* must be non-"NULL".

   On success, return "0". If *cell* is not a cell object, set an
   exception and return "-1".

void PyCell_SET(PyObject *cell, PyObject *value)

   セルオブジェクト *cell* の値を *value* に設定します。 参照カウント
   に対する変更はなく、安全のためのチェックは何も行いません。*cell* は
   非 "NULL" でなければならず、かつセルオブジェクトでなければなりませ
   ん。
