Python supports weak references as first-class objects. There are two specific object types which directly implement weak references. The first is a simple reference object, and the second acts as a proxy for the original object as much as it can.
intPyWeakref_Check(
*ob)
Return non-zero if ob is either a reference or proxy object. This function always succeeds.
intPyWeakref_CheckRef(
*ob)
Return non-zero if ob is a reference object or a subclass of the reference type. This function always succeeds.
intPyWeakref_CheckRefExact(
*ob)
Return non-zero if ob is a reference object, but not a subclass of the reference type. This function always succeeds.
intPyWeakref_CheckProxy(
*ob)
Return non-zero if ob is a proxy object. This function always succeeds.
*PyWeakref_NewRef(
*ob,
*callback)
Return value: New reference. Part of the
.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 referenceable object, this will raise
and return NULL.
*PyWeakref_NewProxy(
*ob,
*callback)
Return value: New reference. Part of the
.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 weakly referenceable object, this will raise
and return NULL.
intPyWeakref_GetRef(
*ref,
**pobj)
Part of the
since version 3.13.Get a
to the referenced object from a weak reference, ref, into *pobj.
On success, set *pobj to a new
to the referenced object and return 1.
If the reference is dead, set *pobj to NULL and return 0.
On error, raise an exception and return -1.
Added in version 3.13.
*PyWeakref_GetObject(
*ref)
Return value: Borrowed reference. Part of the
.Return a
to the referenced object from a weak reference, ref. If the referent is no longer live, returns Py_None.
Note
This function returns a
to the referenced object. This means that you should always call
on the object except when it cannot be destroyed before the last usage of the borrowed reference.
Deprecated since version 3.13, will be removed in version 3.15: Use
instead.
*PyWeakref_GET_OBJECT(
*ref)
Return value: Borrowed reference.Similar to
, but does no error checking.
Deprecated since version 3.13, will be removed in version 3.15: Use
instead.
intPyWeakref_IsDead(
*ref)
Test if the weak reference ref is dead. Returns 1 if the reference is dead, 0 if it is alive, and -1 with an error set if ref is not a weak reference object.
Added in version 3.14.
voidPyObject_ClearWeakRefs(
*object)
Part of the
.This function is called by the
handler to clear weak references.
This iterates through the weak references for object and calls callbacks for those references which have one. It returns when all callbacks have been attempted.
voidPyUnstable_Object_ClearWeakRefsNoCallbacks(
*object)
This is
. It may change without warning in minor releases.
Clears the weakrefs for object without calling the callbacks.
This function is called by the
handler for types with finalizers (i.e.,
). The handler for those objects first calls
to clear weakrefs and call their callbacks, then the finalizer, and finally this function to clear any weakrefs that may have been created by the finalizer.
In most circumstances, it’s more appropriate to use
to clear weakrefs instead of this function.
Added in version 3.13.