From: Fred Drake Date: Wed, 28 Jun 2000 16:15:08 +0000 (+0000) Subject: Enhanced memory-reference information in the description of Py_BuildValue(), X-Git-Tag: v2.0b1~1377 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ec105d099385707db8c58c66a51b28e600501c4c;p=python Enhanced memory-reference information in the description of Py_BuildValue(), based on response from Frank Stajano . --- diff --git a/Doc/ext/ext.tex b/Doc/ext/ext.tex index 8de3158480..4171da9363 100644 --- a/Doc/ext/ext.tex +++ b/Doc/ext/ext.tex @@ -1004,7 +1004,11 @@ parenthesize the format string. 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 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 entry in (round) parentheses is the Python object type that the format