# セルオブジェクト (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` でなければならず、かつセルオブジェクトでなければなりません。