mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-15 21:44:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 12

Implemented a new Py_CLEAR macro. This macro should be used when

Browse source 
decrementing the refcount of variables that might be accessed as a
result of calling Python
This commit is contained in:
Jim Fulton 2004-07-14 19:07:35 +00:00
parent 7a0e8bc283
commit 8c5aeaa277
2 changed files with 25 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
Doc/api/refcounting.tex
View file

@ -42,6 +42,22 @@ of Python objects.
applies.
\end{cfuncdesc}
\begin{cfuncdesc}{void}{Py_CLEAR}{PyObject *o}
Decrement the reference count for object \var{o}. The object may be
\NULL, in which case the macro has no effect; otherwise the effect
is the same as for \cfunction{Py_DECREF()}, except that the argument
is also set to \NULL. The warning for \cfunction{Py_DECREF()}, does
not apply with respect to the object passed because the macro
carefully uses a temporary variable and sets the argument to \NULL
before decrementing it's reference count.
It is a good idea to use this macro whenever decrementing the value
of a variable that might be traversed during garbage collection.
\versionadded{2.4}
\end{cfuncdesc}
The following functions are for runtime dynamic embedding of Python:
\cfunction{Py_IncRef(PyObject *o)}, \cfunction{Py_DecRef(PyObject *o)}.
They are simply exported function versions of \cfunction{Py_XINCREF()} and