mirror of https://github.com/python/cpython.git
Enhanced memory-reference information in the description of Py_BuildValue(),
based on response from Frank Stajano <fstajano@uk.research.att.com>.
This commit is contained in:
parent
cabbc3be5b
commit
ec105d0993
|
@ -1004,7 +1004,11 @@ parenthesize the format string.
|
||||||
When memory buffers are passed as parameters to supply data to build
|
When memory buffers are passed as parameters to supply data to build
|
||||||
objects, as for the \samp{s} and \samp{s\#} formats, the required data
|
objects, as for the \samp{s} and \samp{s\#} formats, the required data
|
||||||
is copied. Buffers provided by the caller are never referenced by the
|
is copied. Buffers provided by the caller are never referenced by the
|
||||||
objects created by \cfunction{Py_BuildValue()}.
|
objects created by \cfunction{Py_BuildValue()}. In other words, if
|
||||||
|
your code invokes \cfunction{malloc()} and passes the allocated memory
|
||||||
|
to \cfunction{Py_BuildValue()}, your code is responsible for
|
||||||
|
calling \cfunction{free()} for that memory once
|
||||||
|
\cfunction{Py_BuildValue()} returns.
|
||||||
|
|
||||||
In the following description, the quoted form is the format unit; the
|
In the following description, the quoted form is the format unit; the
|
||||||
entry in (round) parentheses is the Python object type that the format
|
entry in (round) parentheses is the Python object type that the format
|
||||||
|
|
Loading…
Reference in New Issue