From: Sandro Tosi Date: Sun, 1 Jan 2012 22:41:44 +0000 (+0100) Subject: Issue #13302: backport part of 3ed28f28466f X-Git-Tag: v2.7.3rc1~198 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8448dfa17d4c3bf9009bdb600640d7e550bad734;p=thirdparty%2FPython%2Fcpython.git Issue #13302: backport part of 3ed28f28466f --- diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst index 6599d82fab2e..4f8591b37f4f 100644 --- a/Doc/c-api/arg.rst +++ b/Doc/c-api/arg.rst @@ -24,6 +24,11 @@ the format unit; the entry in (round) parentheses is the Python object type that matches the format unit; and the entry in [square] brackets is the type of the C variable(s) whose address should be passed. +These formats allow to access an object as a contiguous chunk of memory. +You don't have to provide raw storage for the returned unicode or bytes +area. Also, you won't have to release any memory yourself, except with the +``es``, ``es#``, ``et`` and ``et#`` formats. + ``s`` (string or Unicode) [const char \*] Convert a Python string or Unicode object to a C pointer to a character string. You must not provide storage for the string itself; a pointer to