# Objets Cellules

Les objets "Cellules" (cell en anglais) sont utilisés pour implémenter des variables référencées dans de multiples environnements. Pour chacune de ces variables, un objet cellule est créé pour stocker sa valeur ; les variables locales de chaque pile d'exécution qui référence cette valeur contiennent une référence sur les cellules des autres environnements qui utilisent aussi cette variable. Quand la valeur est accédée, la valeur de la cellule est utilisée, au lei de celle de l'objet cellule proprement dit. Ce dé-référencement de l'objet cellule requiert l'intervention du bytecode généré ; il n'est pas automatiquement dé-référencé quand il est accédé. Il est plausible que les objets cellules ne soit utilisés ailleurs.

type `PyCellObject`

  Structure C utilisée pour les objets cellules.

PyTypeObject `PyCell_Type`

  Type objet correspondant aux objets cellules.

int `PyCell_Check`(ob)

  Return true if ob is a cell object; ob must not be `NULL`. This function always succeeds.

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

  Create and return a new cell object containing the value ob. The parameter may be `NULL`.

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

  Renvoie le contenu de la cellule cell.

PyObject *`PyCell_GET`(PyObject *cell)
  Return value: Borrowed reference.

  Return the contents of the cell cell, but without checking that cell is non-`NULL` and a cell object.

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`; if it is not a cell object, `-1` will be returned. On success, `0` will be returned.

void `PyCell_SET`(PyObject *cell, PyObject *value)

  Sets the value of the cell object cell to value. No reference counts are adjusted, and no checks are made for safety; cell must be non-`NULL` and must be a cell object.