# Об’єкти клітинки

«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)

  Повертає true, якщо ob є об’єктом клітинки; ob не має бути `NULL`. Ця функція завжди успішна.

PyObject *PyCell_New(PyObject *ob)
  Return value: New reference.

  Створіть і поверніть новий об’єкт клітинки, що містить значення ob. Параметр може бути `NULL`.

PyObject *PyCell_Get(PyObject *cell)
  Return value: New reference.

  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)
  Return value: Borrowed reference.

  Повертає вміст комірки 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` і має бути об’єктом клітинки.