Ce document est relatif à une vieille version de Python qui n'est plus soutenue. Mettez à jour votre version et lisez Bienvenue sur la documentation de la version stable actuelle de Python.

# Objets à références faibles

Python gère les références faibles comme des objets de première classe. Il existe deux types d'objets spécifiques qui implémentent directement les références faibles. Le premier est un objet de référence simple, et le second agit autant que possible comme un mandataire vers l'objet original.

int `PyWeakref_Check`(ob)

  Return true if ob is either a reference or proxy object. This function always succeeds.

int `PyWeakref_CheckRef`(ob)

  Return true if ob is a reference object. This function always succeeds.

int `PyWeakref_CheckProxy`(ob)

  Return true if ob is a proxy object. This function always succeeds.

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.

  Retourne l'objet référencé à partir d'une référence faible, ref. Si le référence n'existe plus, alors l'objet renvoie `Py_None`.

  Note

  Cette fonction renvoie une référence empruntée à l'objet référencé. Cela signifie que vous devez toujours appeler `Py_INCREF()` sur l'objet sauf si vous savez qu'il ne peut pas être détruit tant que vous l'utilisez encore.

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

  Similaire à `PyWeakref_GetObject()`, mais implémenté comme une macro qui ne vérifie pas les erreurs.