Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Clarify the description of the creation of an owned reference from an API 

function.
This closes SF bug #486657.
This commit is contained in:
Fred Drake 2001-11-29 07:16:19 +00:00
parent 99181ac64e
commit 92024d1a99
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/ext/extending.tex
View File

@ -1291,11 +1291,11 @@ transferred with the reference or not.
Most functions that return a reference to an object pass on ownership
with the reference. In particular, all functions whose function it is
to create a new object, such as \cfunction{PyInt_FromLong()} and
\cfunction{Py_BuildValue()}, pass ownership to the receiver. Even if in
fact, in some cases, you don't receive a reference to a brand new
object, you still receive ownership of the reference. For instance,
\cfunction{PyInt_FromLong()} maintains a cache of popular values and can
return a reference to a cached item.
\cfunction{Py_BuildValue()}, pass ownership to the receiver. Even if
the object is not actually new, you still receive ownership of a new
reference to that object. For instance, \cfunction{PyInt_FromLong()}
maintains a cache of popular values and can return a reference to a
cached item.
Many functions that extract objects from other objects also transfer
ownership with the reference, for instance