XXX Rewrite this section. Normally one only uses indexing, not the .contents attribute! List some recipes with pointers. bool(ptr), POINTER(tp)(), ...?
Pointer instances are created by calling the pointer
function on a
ctypes
type:
>>> from ctypes import * >>> i = c_int(42) >>> pi = pointer(i) >>>
Pointer instances have a contents
attribute which returns the
object to which the pointer points, the i
object above:
>>> pi.contents c_long(42) >>>
Note that ctypes
does not have OOR (original object return), it
constructs a new, equivalent object each time you retrieve an
attribute:
>>> pi.contents is i False >>> pi.contents is pi.contents False >>>
Assigning another c_int instance to the pointer's contents attribute would cause the pointer to point to the memory location where this is stored:
>>> pi.contents = c_int(99) >>> pi.contents c_long(99) >>>
Pointer instances can also be indexed with integers:
>>> pi[0] 99 >>>
Assigning to an integer index changes the pointed to value:
>>> print i c_long(99) >>> pi[0] = 22 >>> print i c_long(22) >>>
It is also possible to use indexes different from 0, but you must know what you're doing, just as in C: You can access or change arbitrary memory locations. Generally you only use this feature if you receive a pointer from a C function, and you know that the pointer actually points to an array instead of a single item.
See About this document... for information on suggesting changes.