Objetos de Referência Fraca

O Python suporta referências fracas como objetos de primeira classe. Existem dois tipos de objetos específicos que implementam diretamente referências fracas. O primeiro é um objeto de referência simples, e o segundo atua como um proxy para o objeto original tanto quanto ele pode.

int PyWeakref_Check(ob)

Retorna True se ob for um objeto de referência ou proxy.

Novo na versão 2.2.

int PyWeakref_CheckRef(ob)

Retornar True se ob for um objeto de referência.

Novo na versão 2.2.

int PyWeakref_CheckProxy(ob)

Retornar True se ob for um objeto proxy.

Novo na versão 2.2.

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.

Novo na versão 2.2.

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.

Novo na versão 2.2.

PyObject* PyWeakref_GetObject(PyObject *ref)
Return value: Borrowed reference.

Retorna o objeto referenciado de uma referência fraca, ref. Se o referente não estiver mais em tempo real, retorna Py_None.

Novo na versão 2.2.

Aviso

Esta função retorna referência emprestada ao objeto referenciado. Isso significa que você deve sempre invocar Py_INCREF() no objeto, exceto se você souber que não pode ser destruído enquanto você ainda está usando.

PyObject* PyWeakref_GET_OBJECT(PyObject *ref)
Return value: Borrowed reference.

Semelhante a PyWeakref_GetObject(), mas implementado como uma macro que não verifica erros.

Novo na versão 2.2.