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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
|
# mode: run
from __future__ import unicode_literals
# these imports allow testing different ways to access [[cython.]view.]array()
from cython.view cimport array
from cython cimport view as v
cimport cython as cy
include "../testsupport/cythonarrayutil.pxi"
def length(shape):
"""
>>> len(length((2,)))
2
>>> len(length((2,3)))
2
>>> len(length((5,3,2)))
5
"""
cdef array cvarray = array(shape=shape, itemsize=sizeof(int), format="i", mode='c')
assert len(cvarray) == shape[0]
return cvarray
def contiguity():
'''
>>> contiguity()
12 4
2 3
2
<BLANKLINE>
4 8
2 3
2
'''
cdef v.array cvarray = cy.view.array(shape=(2,3), itemsize=sizeof(int), format="i", mode='c')
assert cvarray.len == 2*3*sizeof(int), (cvarray.len, 2*3*sizeof(int))
assert cvarray.itemsize == sizeof(int)
print cvarray.strides[0], cvarray.strides[1]
print cvarray.shape[0], cvarray.shape[1]
print cvarray.ndim
print
cdef v.array farray = v.array(shape=(2,3), itemsize=sizeof(int), format="i", mode='fortran')
assert farray.len == 2*3*sizeof(int)
assert farray.itemsize == sizeof(int)
print farray.strides[0], farray.strides[1]
print farray.shape[0], farray.shape[1]
print farray.ndim
def acquire():
'''
>>> acquire()
'''
cdef object[int, ndim=1, mode="c"] buf1d = \
array(shape=(10,), itemsize=sizeof(int), format='i', mode='c')
cdef object[int, ndim=2, mode="c"] buf2d = \
array(shape=(10,10), itemsize=sizeof(int), format='i')
cdef object[unsigned long, ndim=3, mode='fortran'] buf3d = \
array(shape=(1,2,3), itemsize=sizeof(unsigned long), format='L', mode='fortran')
cdef object[long double, ndim=3, mode='fortran'] bufld = \
array(shape=(1,2,3), itemsize=sizeof(long double), format='g', mode='fortran')
def full_or_strided():
'''
>>> full_or_strided()
'''
cdef object[float, ndim=2, mode='full'] fullbuf = \
array(shape=(10,10), itemsize=sizeof(float), format='f', mode='c')
cdef object[long long int, ndim=3, mode='strided'] stridedbuf = \
array(shape=(1,2,3), itemsize=sizeof(long long int), format='q', mode='fortran')
def dont_allocate_buffer():
"""
>>> dont_allocate_buffer()
callback called
"""
cdef array result = array((10, 10), itemsize=sizeof(int), format='i', allocate_buffer=False)
assert result.data == NULL
result.callback_free_data = callback
result = None
def test_cython_array_getbuffer():
"""
>>> test_cython_array_getbuffer()
98
61
98
61
"""
cdef int[:, ::1] cslice = create_array((14, 10), 'c')
cdef int[::1, :] fslice = create_array((14, 10), 'fortran')
print cslice[9, 8]
print cslice[6, 1]
print fslice[9, 8]
print fslice[6, 1]
def test_cython_array_index():
"""
>>> test_cython_array_index()
98
61
98
61
"""
c_array = create_array((14, 10), 'c')
f_array = create_array((14, 10), 'fortran')
print c_array[9, 8]
print c_array[6, 1]
print f_array[9, 8]
print f_array[6, 1]
cdef int *getp(int dim1=10, int dim2=10, dim3=1) except NULL:
print "getp()"
cdef int *p = <int *> malloc(dim1 * dim2 * dim3 * sizeof(int))
if p == NULL:
raise MemoryError
for i in range(dim1 * dim2 * dim3):
p[i] = i
return p
cdef void callback_free_data(void *p) noexcept:
print 'callback free data called'
free(p)
def test_array_from_pointer():
"""
>>> test_array_from_pointer()
getp()
69
c
getp()
callback free data called
fortran
getp()
56
getp()
56
getp()
119
callback free data called
"""
cdef int *p = getp()
cdef array c_arr = <int[:10, :10]> p
c_arr.callback_free_data = callback_free_data
print c_arr[6, 9]
print c_arr.mode
c_arr = (<int[:10:1, :10]> getp())
print c_arr.mode
c_arr.callback_free_data = free
c_arr = <int[:10, :10]> getp()
c_arr.callback_free_data = free
cdef int[:, ::1] mslice = c_arr
print mslice[5, 6]
c_arr = <int[:12, :10]> getp(12, 10)
c_arr.callback_free_data = free
print c_arr[5, 6]
cdef int m = 12
cdef int n = 10
c_arr = <int[:m, :n]> getp(m, n)
c_arr.callback_free_data = callback_free_data
print c_arr[m - 1, n - 1]
def test_array_from_pointer_3d():
"""
>>> test_array_from_pointer_3d()
getp()
3 3
True True
"""
cdef int *p = getp(2, 2, 2)
cdef array c_arr = <int[:2, :2, :2:1]> p
cdef array f_arr = <int[:2:1, :2, :2]> p
cdef int[:, :, ::1] m1 = c_arr
cdef int[::1, :, :] m2 = f_arr
print m1[0, 1, 1], m2[1, 1, 0]
print m1.is_c_contig(), m2.is_f_contig()
def test_cyarray_from_carray():
"""
>>> test_cyarray_from_carray()
0 8 21
0 8 21
"""
cdef int[7][8] a
for i in range(7):
for j in range(8):
a[i][j] = i * 8 + j
cdef int[:, :] mslice = <int[:, :]> a
print mslice[0, 0], mslice[1, 0], mslice[2, 5]
mslice = a
print mslice[0, 0], mslice[1, 0], mslice[2, 5]
class InheritFrom(v.array):
"""
Test is just to confirm it works, not to do anything meaningful with it
(Be aware that itemsize isn't necessarily right)
>>> inst = InheritFrom(shape=(3, 3, 3), itemsize=4, format="i")
"""
pass
def test_char_array_in_python_api(*shape):
"""
>>> import sys
>>> if sys.version_info[0] < 3:
... def bytes(b): return memoryview(b).tobytes() # don't call str()
>>> arr1d = test_char_array_in_python_api(10)
>>> print(bytes(arr1d).decode('ascii'))
xxxxxxxxxx
>>> len(bytes(arr1d))
10
>>> arr2d = test_char_array_in_python_api(10, 2)
>>> print(bytes(arr2d).decode('ascii'))
xxxxxxxxxxxxxxxxxxxx
>>> len(bytes(arr2d))
20
# memoryview
>>> len(bytes(memoryview(arr1d)))
10
>>> bytes(memoryview(arr1d)) == bytes(arr1d)
True
>>> len(bytes(memoryview(arr2d)))
20
>>> bytes(memoryview(arr2d)) == bytes(arr2d)
True
# BytesIO
>>> from io import BytesIO
>>> BytesIO(arr1d).read() == bytes(arr1d)
True
>>> BytesIO(arr2d).read() == bytes(arr2d)
True
>>> b = BytesIO()
>>> print(b.write(arr1d))
10
>>> b.getvalue() == bytes(arr1d) or b.getvalue()
True
>>> b = BytesIO()
>>> print(b.write(arr2d))
20
>>> b.getvalue() == bytes(arr2d) or b.getvalue()
True
# BufferedWriter (uses PyBUF_SIMPLE, see https://github.com/cython/cython/issues/3775)
>>> from io import BufferedWriter
>>> b = BytesIO()
>>> bw = BufferedWriter(b)
>>> print(bw.write(arr1d))
10
>>> bw.flush()
>>> b.getvalue() == bytes(arr1d)
True
>>> b = BytesIO()
>>> bw = BufferedWriter(b)
>>> print(bw.write(arr2d))
20
>>> bw.flush()
>>> b.getvalue() == bytes(arr2d)
True
"""
arr = array(shape=shape, itemsize=sizeof(char), format='c', mode='c')
arr[:] = b'x'
return arr
def test_is_Sequence():
"""
>>> test_is_Sequence()
1
1
True
"""
import sys
if sys.version_info < (3, 3):
from collections import Sequence
else:
from collections.abc import Sequence
arr = array(shape=(5,), itemsize=sizeof(char), format='c', mode='c')
for i in range(arr.shape[0]):
arr[i] = f'{i}'.encode('ascii')
print(arr.count(b'1')) # test for presence of added collection method
print(arr.index(b'1')) # test for presence of added collection method
if sys.version_info >= (3, 10):
# test structural pattern match in Python
# (because Cython hasn't implemented it yet, and because the details
# of what Python considers a sequence are important)
globs = {'arr': arr}
exec("""
match arr:
case [*_]:
res = True
case _:
res = False
""", globs)
assert globs['res']
return isinstance(arr, Sequence)
|