Objetos referência fraca

Python oferece suporte a 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 intermediário entre o objeto original e o primeiro, tanto quanto possível.

int PyWeakref_Check(PyObject *ob)

Retorna não zero se ob for um objeto referência ou um objeto intermediário. Esta função sempre tem sucesso.

int PyWeakref_CheckRef(PyObject *ob)

Retorna não zero se ob for um objeto referência ou uma subclasse do tipo de referência. Esta função sempre tem sucesso.

int PyWeakref_CheckRefExact(PyObject *ob)

Retorna não zero se ob for um objeto referência, mas não uma subclasse do tipo de referência. Esta função sempre tem sucesso.

int PyWeakref_CheckProxy(PyObject *ob)

Retorna não zero se ob for um objeto intermediário. Esta função sempre tem sucesso.

PyObject *PyWeakref_NewRef(PyObject *ob, PyObject *callback)

Retorna valor: Nova referência. Parte da ABI Estável.

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 TypeError and return NULL.

Ver também

PyType_SUPPORTS_WEAKREFS() para verificar se ob é fracamente referenciável.

PyObject *PyWeakref_NewProxy(PyObject *ob, PyObject *callback)

Retorna valor: Nova referência. Parte da ABI Estável.

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 TypeError and return NULL.

Ver também

PyType_SUPPORTS_WEAKREFS() para verificar se ob é fracamente referenciável.

int PyWeakref_GetRef(PyObject *ref, PyObject **pobj)

Parte da ABI Estável desde a versão 3.13.

Obtém uma referência forte para o objeto referenciado a partir de uma referência fraca, ref, em *pobj.

• Em caso de sucesso, define *pobj como uma nova referência forte para o objeto referenciado e retorna 1.

• Se a referência estiver quebrada, define *pobj como NULL e retorna 0.

• Em caso de erro, levanta uma exceção e retorna -1.

Adicionado na versão 3.13.

PyObject *PyWeakref_GetObject(PyObject *ref)

Retorna valor: Referência emprestada. Parte da ABI Estável.

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

Nota

Esta função retorna uma referência emprestada para o objeto referenciado. Isso significa que você deve sempre chamar Py_INCREF() no objeto, exceto quando ele não puder ser destruído antes do último uso da referência emprestada.

Descontinuado desde a versão 3.13, será removido na versão 3.15: Usa PyWeakref_GetRef().

PyObject *PyWeakref_GET_OBJECT(PyObject *ref)

Retorna valor: Referência emprestada.

Semelhante a PyWeakref_GetObject(), mas não verifica erros.

Descontinuado desde a versão 3.13, será removido na versão 3.15: Usa PyWeakref_GetRef().

int PyWeakref_IsDead(PyObject *ref)

Testa se a referência fraca ref está inativa. Retorna 1 se a referência estiver inativa, 0 se estiver ativa e -1 com um erro definido se ref não for um objeto referência fraca.

Adicionado na versão 3.14.

void PyObject_ClearWeakRefs(PyObject *object)

Parte da ABI Estável.

Esta função é chamada pelo tratador tp_dealloc para limpar referências fracas.

Isso itera pelas referências fracas para object e chama as funções de retorno para as referências que possuem um. Ele retorna quando todas as funções de retorno tiverem sido executadas.

void PyUnstable_Object_ClearWeakRefsNoCallbacks(PyObject *object)

Esta é uma API Instável. Isso pode se alterado sem aviso em lançamentos menores.

Limpa as referências fracas para object sem chamar as funções de retorno.

Esta função é chamada pelo manipulador tp_dealloc para tipos com finalizadores (por exemplo, __del__()). O manipulador para esses objetos primeiro chama PyObject_ClearWeakRefs() para limpar referências fracas e chamar suas funções de retorno, depois o finalizador e, finalmente, esta função para limpar quaisquer referências fracas que possam ter sido criadas pelo finalizador.

Na maioria das circunstâncias, é mais apropriado usar PyObject_ClearWeakRefs() para limpar referências fracas em vez desta função.

Adicionado na versão 3.13.