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.

int PyWeakref_CheckRef(ob)

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

int PyWeakref_CheckProxy(ob)

   Retornar True se *ob* for um objeto proxy.

PyObject* PyWeakref_NewRef(PyObject *ob, PyObject *callback)
    *Return value: New reference.*

   Retorna um objeto de referência fraco para o objeto *ob*. Isso
   sempre retornará uma nova referência, mas não é garantido para
   criar um novo objeto; um objeto de referência existente pode ser
   retornado. O segundo parâmetro, *callback*, pode ser um objeto
   invocável que recebe notificação quando *ob* for lixo coletado; ele
   deve aceitar um único parâmetro, que será o objeto de referência
   fraco propriamente dito. *callback* também pode ser "None" ou
   *NULL*. Se *ob* não for um objeto fracamente referenciável, ou se
   *callback* não for invocado, "None", ou *NULL*, isso retornará
   *NULL* e levantará a "TypeError".

PyObject* PyWeakref_NewProxy(PyObject *ob, PyObject *callback)
    *Return value: New reference.*

   Devolve um objeto proxy de referência fraco para o objeto *ob*.
   Isso sempre retornará uma nova referência, mas não é garantido para
   criar um novo objeto; Um objeto proxy existente pode ser retornado.
   O segundo parâmetro, *callback*, pode ser um objeto invocável que
   recebe notificação quando *ob* é lixo coletado; Ele deve aceitar um
   único parâmetro, que será o objeto de referência fraco propriamente
   dito. O *callback* também pode ser "None" ou *NULL*. Se *ob* não é
   um objeto fracamente referenciável, ou se *callback* não for
   chamado, "None", ou *NULL*, isso retornará *NULL* e levanta a
   exceção "TypeError".

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

   Nota:

     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.
