1berry/cpython
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

#8578: mention danger of not incref'ing weak referenced object.

Browse Source
This commit is contained in:
Georg Brandl 2010-08-02 17:49:25 +00:00
parent 2d3c4e79a1
commit 502c3eb52f
1 changed files with 8 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/c-api/weakref.rst
View File

@ -53,7 +53,14 @@ as much as it can.
.. cfunction:: PyObject* PyWeakref_GetObject(PyObject *ref)
Return the referenced object from a weak reference, *ref*. If the referent is
no longer live, returns ``None``.
no longer live, returns :const:`Py_None`.
.. warning::
This function returns a **borrowed reference** to the referenced object.
This means that you should always call :cfunc:`Py_INCREF` on the object
except if you know that it cannot be destroyed while you are still
using it.
.. cfunction:: PyObject* PyWeakref_GET_OBJECT(PyObject *ref)