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.
