# 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)

  Renvoie vrai si ob est soit une référence, soit un objet proxy.

int `PyWeakref_CheckRef`(ob)

  Retourne vrai si ob est un objet référence.

int `PyWeakref_CheckProxy`(ob)

  Retourne vrai si ob est un objet proxy

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

  Retourne un objet de référence faible pour l’objet ob. Elle renvoie toujours une nouvelle référence, mais cela ne signifie pas qu’un nouvel objet est créé ; un objet référence existant peut être renvoyé. Le second paramètre, callback, peut être un objet appelable qui reçoit une notification lorsque ob est collecté par le ramasse-miette (garbage collected en anglais) ; il doit accepter un paramètre unique, qui est l’objet référence faible lui-même. callback peut aussi être positionné à `None` ou à NULL. Si ob n’est pas un objet faiblement référençable, ou si callback n’est pas appelable, `None`` ou NULL, ceci retourne NULL et lève une `TypeError`.

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

  Retourne un objet mandataire à référence faible pour l’objet ob. Ceci renvoie toujours une nouvelle référence, mais ne garantit pas la création d’un nouvel objet ; un objet proxy existant peut être retourné. Le second paramètre, callback, peut être un objet appelable qui reçoit une notification lorsque ob est collecté ; il doit accepter un seul paramètre, qui sera l’objet de référence faible lui-même. callback peut aussi être `None` ou NULLL. Si ob n’est pas un objet faiblement référençable, ou si callback n’est pas appelable, `None`` ou NULL, ceci renvoie NULL et lève une `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.