blame | history | raw
tzh
2024-08-22 c7d0944258c7d0943aa7b2211498fd612971ce27 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

ó 


Z\¬Qc@s‡dZddlZddlZddlZddlZdejfd„ƒYZedkrƒejdkrƒej    ej


jƒqƒndS(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ÿÿÿÿNtTestCasecBs#eZejdkr!d„ZnRS(icCstjtjjƒdS(N(tdoctestttestmodtctypesttestttest_objects(tself((s`/tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/ctypes/test/test_objects.pyRAs(t__name__t


__module__tsyst


hexversionR(((s`/tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/ctypes/test/test_objects.pyR=st__main__i(t__doc__tunittestRR    tctypes.test.test_objectsRRRR


RRR(((s`/tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/ctypes/test/test_objects.pyt<module>7s$