]> granicus.if.org Git - python/commitdiff
#14201: Update ctypes docs to match behavior changed from 214b28d7a999.
authorR David Murray <rdmurray@bitdance.com>
Sat, 4 Oct 2014 22:25:07 +0000 (18:25 -0400)
committerR David Murray <rdmurray@bitdance.com>
Sat, 4 Oct 2014 22:25:07 +0000 (18:25 -0400)
Original patch by Erik Johansson, slightly updated by Meador Inge.

Doc/library/ctypes.rst

index f46da85a577e9173c832539a9d9709b62bb20393..aff42531ac67011bea3d36b1aa9775374c6eb16e 100644 (file)
@@ -1386,11 +1386,16 @@ copy of the windows error code.
    The default mode which is used to load shared libraries.  On OSX 10.3, this is
    *RTLD_GLOBAL*, otherwise it is the same as *RTLD_LOCAL*.
 
-Instances of these classes have no public methods, however :meth:`__getattr__`
-and :meth:`__getitem__` have special behavior: functions exported by the shared
-library can be accessed as attributes of by index.  Please note that both
-:meth:`__getattr__` and :meth:`__getitem__` cache their result, so calling them
-repeatedly returns the same object each time.
+Instances of these classes have no public methods.  Functions exported by the
+shared library can be accessed as attributes or by index.  Please note that
+accessing the function through an attribute caches the result and therefore
+accessing it repeatedly returns the same object each time.  On the other hand,
+accessing it through an index returns a new object each time:
+
+   >>> libc.time == libc.time
+   True
+   >>> libc['time'] == libc['time']
+   False
 
 The following public attributes are available, their name starts with an
 underscore to not clash with exported function names: