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.
