From d53dfa3fb1c86e97ad787bdcb3c7e068a7ba2580 Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Thu, 6 Jan 2011 07:16:31 +0000 Subject: [PATCH] Issue #10840: make it explicit that "s*" and friends provide contiguous memory. --- Doc/c-api/arg.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst index a32dd09c8e..d4dda7c693 100644 --- a/Doc/c-api/arg.rst +++ b/Doc/c-api/arg.rst @@ -30,9 +30,10 @@ variable(s) whose address should be passed. Strings and buffers ------------------- -These formats do not expect you to provide raw storage for the returned string -or bytes. Also, you won't have to release any memory yourself, except with -the ``es``, ``es#``, ``et`` and ``et#`` formats. +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. However, when a :c:type:`Py_buffer` structure gets filled, the underlying buffer is locked so that the caller can subsequently use the buffer even -- 2.40.0