# Conteo de referencias

Los macros de esta sección se utilizan para administrar conteos de referencia de objetos Python.

void `Py_INCREF`(PyObject *o)

  Incrementa el conteo de referencia para el objeto o. El objeto no debe ser `NULL`; si no está seguro de que no sea `NULL`, use `Py_XINCREF()`.

void `Py_XINCREF`(PyObject *o)

  Incrementa el conteo de referencia para el objeto o. El objeto puede ser `NULL`, en cuyo caso el macro no tiene efecto.

void `Py_DECREF`(PyObject *o)

  Disminuye el conteo de referencia para el objeto o. El objeto no debe ser `NULL`; si no está seguro de que no sea `NULL`, use `Py_XDECREF()`. Si el conteo de referencia llega a cero, se invoca la función de desasignación del tipo de objeto (que no debe ser `NULL`).

  Advertencia

  La función de desasignación puede hacer que se invoque un código arbitrario de Python (por ejemplo, cuando se desasigna una instancia de clase con un método `__del__()`). Si bien las excepciones en dicho código no se propagan, el código ejecutado tiene acceso libre a todas las variables globales de Python. Esto significa que cualquier objeto al que se pueda acceder desde una variable global debe estar en un estado coherente antes de invocar `Py_DECREF()`. Por ejemplo, el código para eliminar un objeto de una lista debe copiar una referencia al objeto eliminado en una variable temporal, actualizar la estructura de datos de la lista y luego llamar a `Py_DECREF()` para la variable temporal.

void `Py_XDECREF`(PyObject *o)

  Disminuye el conteo de referencia para el objeto o. El objeto puede ser `NULL`, en cuyo caso el macro no tiene efecto; de lo contrario, el efecto es el mismo que para `Py_DECREF()`, y se aplica la misma advertencia.

void `Py_CLEAR`(PyObject *o)

  Disminuye el conteo de referencia para el objeto o. El objeto puede ser `NULL`, en cuyo caso el macro no tiene efecto; de lo contrario, el efecto es el mismo que para `Py_DECREF()`, excepto que el argumento también se establece en `NULL`. La advertencia para `Py_DECREF()` no se aplica con respecto al objeto pasado porque el macro usa cuidadosamente una variable temporal y establece el argumento en `NULL` antes de disminuir su conteo de referencia.

  Es una buena idea usar este macro siempre que disminuya el conteo de referencia de un objeto que pueda atravesarse durante la recolección de basura.

Las siguientes funciones son para la incorporación dinámica de Python en tiempo de ejecución: `Py_IncRef(PyObject *o)`, `Py_DecRef(PyObject *o)`. Simplemente son versiones de funciones exportadas de `Py_XINCREF()` y `Py_XDECREF()`, respectivamente.

Las siguientes funciones o macros son solo para uso dentro del núcleo del intérprete: `_Py_Dealloc()`, `_Py_ForgetReference()`, `_Py_NewReference()`, así como la variable global `_Py_RefTotal`.