Objetos celda
*************

Los objetos celda (*cell*) se utilizan para implementar variables a
las que hacen referencia varios ámbitos. Para cada variable, se crea
un objeto de celda para almacenar el valor; Las variables locales de
cada marco de pila que hace referencia al valor contienen una
referencia a las celdas de ámbitos externos que también usan esa
variable. Cuando se accede al valor, se utiliza el valor contenido en
la celda en lugar del objeto de la celda en sí. Esta desreferenciación
del objeto de celda requiere soporte del código de bytes generado;
estos no se eliminan automáticamente cuando se accede a ellos. No es
probable que los objetos celda sean útiles en otros lugares.

type PyCellObject

   La estructura C utilizada para objetos celda.

PyTypeObject PyCell_Type

   El objeto tipo correspondiente a los objetos celda.

int PyCell_Check(PyObject *ob)

   Retorna verdadero si *ob* es un objeto de celda; *ob* no debe ser
   "NULL". Esta función siempre finaliza con éxito.

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

   Crea y retorna un nuevo objeto de celda que contiene el valor *ob*.
   El parámetro puede ser "NULL".

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

   Retorna el contenido de la celda *cell*.

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

   Retorna el contenido de la celda *cell*, pero sin verificar que
   *cell* no sea "NULL" y que sea un objeto de celda.

int PyCell_Set(PyObject *cell, PyObject *value)

   Establece el contenido del objeto de celda *cell* con el valor
   *value*. Esto libera la referencia a cualquier contenido actual de
   la celda. *value* puede ser "NULL". *cell* no debe ser "NULL"; Si
   no es un objeto de celda, se retornará "-1". En caso de éxito, se
   retornará "0".

void PyCell_SET(PyObject *cell, PyObject *value)

   Establece el valor del objeto de celda *cell* en el valor *value*.
   No se ajustan los recuentos de referencia y no se realizan
   verificaciones de seguridad; *cell* no debe ser "NULL" y debe ser
   un objeto de celda.
