This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

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

  Nouveau dans la version 2.2.

int `PyWeakref_CheckRef`(ob)

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

  Nouveau dans la version 2.2.

int `PyWeakref_CheckProxy`(ob)

  Retourne vrai si ob est un objet proxy

  Nouveau dans la version 2.2.

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`.

  Nouveau dans la version 2.2.

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`.

  Nouveau dans la version 2.2.

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`.

  Nouveau dans la version 2.2.

  Avertissement

  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.

  Nouveau dans la version 2.2.