[Python-checkins] cpython (3.2): Issue #17378: ctypes documentation fix.

Fri Mar 8 14:33:58 CET 2013

http://hg.python.org/cpython/rev/76be5efa0d86
changeset: 82544:76be5efa0d86
branch: 3.2
parent: 82537:c8b2ed53b884
user: Eli Bendersky <eliben at gmail.com>
date: Fri Mar 08 05:31:54 2013 -0800
summary:
 Issue #17378: ctypes documentation fix.
Document that ctypes automatically applies byref() when argtypes declares
POINTER.
files:
 Doc/library/ctypes.rst | 5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst
--- a/Doc/library/ctypes.rst
+++ b/Doc/library/ctypes.rst
@@ -817,6 +817,11 @@
 3
 >>>
 
+In addition, if a function argument is explicitly declared to be a pointer type
+(such as ``POINTER(c_int)``) in :attr:`argtypes`, an object of the pointed
+type (``c_int`` in this case) can be passed to the function. ctypes will apply
+the required :func:`byref` conversion in this case automatically.
+
 To set a POINTER type field to ``NULL``, you can assign ``None``::
 
 >>> bar.values = None
-- 
Repository URL: http://hg.python.org/cpython
