�
B��cc @ su d Z d d l Z d d l Z d d l Z d d l Z d e j f d � � YZ e d k rq e j e j j
� n d S( s3
This tests the '_objects' attribute of ctypes instances. '_objects'
holds references to objects that must be kept alive as long as the
ctypes instance, to make sure that the memory buffer is valid.
WARNING: The '_objects' attribute is exposed ONLY for debugging ctypes itself,
it MUST NEVER BE MODIFIED!
'_objects' is initialized to a dictionary on first use, before that it
is None.
Here is an array of string pointers:
>>> from ctypes import *
>>> array = (c_char_p * 5)()
>>> print array._objects
None
>>>
The memory block stores pointers to strings, and the strings itself
assigned from Python must be kept.
>>> array[4] = 'foo bar'
>>> array._objects
{'4': 'foo bar'}
>>> array[4]
'foo bar'
>>>
It gets more complicated when the ctypes instance itself is contained
in a 'base' object.
>>> class X(Structure):
... _fields_ = [("x", c_int), ("y", c_int), ("array", c_char_p * 5)]
...
>>> x = X()
>>> print x._objects
None
>>>
The'array' attribute of the 'x' object shares part of the memory buffer
of 'x' ('_b_base_' is either None, or the root object owning the memory block):
>>> print x.array._b_base_ # doctest: +ELLIPSIS
<ctypes.test.test_objects.X object at 0x...>
>>>
>>> x.array[0] = 'spam spam spam'
>>> x._objects
{'0:2': 'spam spam spam'}
>>> x.array._b_base_._objects
{'0:2': 'spam spam spam'}
>>>
i����Nt TestCasec B s e Z d � Z RS( c C s/ t j t j j � \ } } | j | d � d S( Ns! doctests failed, see output above( t doctestt testmodt ctypest testt test_objectst assertFalse( t selft failurest tests( ( s? /usr/local/python-2.7/lib/python2.7/ctypes/test/test_objects.pyR > s ( t __name__t
__module__R ( ( ( s? /usr/local/python-2.7/lib/python2.7/ctypes/test/test_objects.pyR = s t __main__( t __doc__t unittestR t syst ctypes.test.test_objectsR R R
R R R ( ( ( s? /usr/local/python-2.7/lib/python2.7/ctypes/test/test_objects.pyt <module>7 s
$