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