# Objetos de referencia débil

Python soporta referencias débiles como objetos de primera clase. Hay dos tipos de objetos específicos que implementan directamente referencias débiles. El primero es un objeto con referencia simple, y el segundo actúa como un proxy del objeto original tanto como pueda.

int `PyWeakref_Check`(ob)

  Retorna verdad (true) si ob es una referencia o un objeto proxy.

int `PyWeakref_CheckRef`(ob)

  Retorna verdad (true) si ob es un objeto de referencia.

int `PyWeakref_CheckProxy`(ob)

  Retorna verdad (true) si ob es un objeto proxy.

PyObject* `PyWeakref_NewRef`(PyObject *ob, PyObject *callback)
  Return value: New reference.

  Return a weak reference object for the object ob. This will always return a new reference, but is not guaranteed to create a new object; an existing reference object may be returned. The second parameter, callback, can be a callable object that receives notification when ob is garbage collected; it should accept a single parameter, which will be the weak reference object itself. callback may also be `None` or `NULL`. If ob is not a weakly-referencable object, or if callback is not callable, `None`, or `NULL`, this will return `NULL` and raise `TypeError`.

PyObject* `PyWeakref_NewProxy`(PyObject *ob, PyObject *callback)
  Return value: New reference.

  Return a weak reference proxy object for the object ob. This will always return a new reference, but is not guaranteed to create a new object; an existing proxy object may be returned. The second parameter, callback, can be a callable object that receives notification when ob is garbage collected; it should accept a single parameter, which will be the weak reference object itself. callback may also be `None` or `NULL`. If ob is not a weakly-referencable object, or if callback is not callable, `None`, or `NULL`, this will return `NULL` and raise `TypeError`.

PyObject* `PyWeakref_GetObject`(PyObject *ref)
  Return value: Borrowed reference.

  Retorna el objeto referenciado desde una referencia débil, ref. Si el referente no está vivo, retornará `Py_None`.

  Nota

  Esta función retorna una referencia prestada al objeto referenciado. Esto significa que siempre debes llamar `Py_INCREF()` en el objeto excepto si sabes que no puede ser destruido mientras lo estés usando.

PyObject* `PyWeakref_GET_OBJECT`(PyObject *ref)
  Return value: Borrowed reference.

  Similar a `PyWeakref_GetObject()`, pero implementado como un macro que no verifica errores.