1 | /* Implementation helper: a struct that looks like a tuple. See timemodule
|
---|
2 | and posixmodule for example uses. */
|
---|
3 |
|
---|
4 | #include "Python.h"
|
---|
5 | #include "structmember.h"
|
---|
6 | #include "structseq.h"
|
---|
7 |
|
---|
8 | static char visible_length_key[] = "n_sequence_fields";
|
---|
9 | static char real_length_key[] = "n_fields";
|
---|
10 | static char unnamed_fields_key[] = "n_unnamed_fields";
|
---|
11 |
|
---|
12 | /* Fields with this name have only a field index, not a field name.
|
---|
13 | They are only allowed for indices < n_visible_fields. */
|
---|
14 | char *PyStructSequence_UnnamedField = "unnamed field";
|
---|
15 |
|
---|
16 | #define VISIBLE_SIZE(op) ((op)->ob_size)
|
---|
17 | #define VISIBLE_SIZE_TP(tp) PyInt_AsLong( \
|
---|
18 | PyDict_GetItemString((tp)->tp_dict, visible_length_key))
|
---|
19 |
|
---|
20 | #define REAL_SIZE_TP(tp) PyInt_AsLong( \
|
---|
21 | PyDict_GetItemString((tp)->tp_dict, real_length_key))
|
---|
22 | #define REAL_SIZE(op) REAL_SIZE_TP((op)->ob_type)
|
---|
23 |
|
---|
24 | #define UNNAMED_FIELDS_TP(tp) PyInt_AsLong( \
|
---|
25 | PyDict_GetItemString((tp)->tp_dict, unnamed_fields_key))
|
---|
26 | #define UNNAMED_FIELDS(op) UNNAMED_FIELDS_TP((op)->ob_type)
|
---|
27 |
|
---|
28 |
|
---|
29 | PyObject *
|
---|
30 | PyStructSequence_New(PyTypeObject *type)
|
---|
31 | {
|
---|
32 | PyStructSequence *obj;
|
---|
33 |
|
---|
34 | obj = PyObject_New(PyStructSequence, type);
|
---|
35 | obj->ob_size = VISIBLE_SIZE_TP(type);
|
---|
36 |
|
---|
37 | return (PyObject*) obj;
|
---|
38 | }
|
---|
39 |
|
---|
40 | static void
|
---|
41 | structseq_dealloc(PyStructSequence *obj)
|
---|
42 | {
|
---|
43 | Py_ssize_t i, size;
|
---|
44 |
|
---|
45 | size = REAL_SIZE(obj);
|
---|
46 | for (i = 0; i < size; ++i) {
|
---|
47 | Py_XDECREF(obj->ob_item[i]);
|
---|
48 | }
|
---|
49 | PyObject_Del(obj);
|
---|
50 | }
|
---|
51 |
|
---|
52 | static Py_ssize_t
|
---|
53 | structseq_length(PyStructSequence *obj)
|
---|
54 | {
|
---|
55 | return VISIBLE_SIZE(obj);
|
---|
56 | }
|
---|
57 |
|
---|
58 | static PyObject*
|
---|
59 | structseq_item(PyStructSequence *obj, Py_ssize_t i)
|
---|
60 | {
|
---|
61 | if (i < 0 || i >= VISIBLE_SIZE(obj)) {
|
---|
62 | PyErr_SetString(PyExc_IndexError, "tuple index out of range");
|
---|
63 | return NULL;
|
---|
64 | }
|
---|
65 | Py_INCREF(obj->ob_item[i]);
|
---|
66 | return obj->ob_item[i];
|
---|
67 | }
|
---|
68 |
|
---|
69 | static PyObject*
|
---|
70 | structseq_slice(PyStructSequence *obj, Py_ssize_t low, Py_ssize_t high)
|
---|
71 | {
|
---|
72 | PyTupleObject *np;
|
---|
73 | Py_ssize_t i;
|
---|
74 |
|
---|
75 | if (low < 0)
|
---|
76 | low = 0;
|
---|
77 | if (high > VISIBLE_SIZE(obj))
|
---|
78 | high = VISIBLE_SIZE(obj);
|
---|
79 | if (high < low)
|
---|
80 | high = low;
|
---|
81 | np = (PyTupleObject *)PyTuple_New(high-low);
|
---|
82 | if (np == NULL)
|
---|
83 | return NULL;
|
---|
84 | for(i = low; i < high; ++i) {
|
---|
85 | PyObject *v = obj->ob_item[i];
|
---|
86 | Py_INCREF(v);
|
---|
87 | PyTuple_SET_ITEM(np, i-low, v);
|
---|
88 | }
|
---|
89 | return (PyObject *) np;
|
---|
90 | }
|
---|
91 |
|
---|
92 | static PyObject *
|
---|
93 | structseq_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
|
---|
94 | {
|
---|
95 | PyObject *arg = NULL;
|
---|
96 | PyObject *dict = NULL;
|
---|
97 | PyObject *ob;
|
---|
98 | PyStructSequence *res = NULL;
|
---|
99 | Py_ssize_t len, min_len, max_len, i, n_unnamed_fields;
|
---|
100 | static char *kwlist[] = {"sequence", "dict", 0};
|
---|
101 |
|
---|
102 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:structseq",
|
---|
103 | kwlist, &arg, &dict))
|
---|
104 | return NULL;
|
---|
105 |
|
---|
106 | arg = PySequence_Fast(arg, "constructor requires a sequence");
|
---|
107 |
|
---|
108 | if (!arg) {
|
---|
109 | return NULL;
|
---|
110 | }
|
---|
111 |
|
---|
112 | if (dict && !PyDict_Check(dict)) {
|
---|
113 | PyErr_Format(PyExc_TypeError,
|
---|
114 | "%.500s() takes a dict as second arg, if any",
|
---|
115 | type->tp_name);
|
---|
116 | Py_DECREF(arg);
|
---|
117 | return NULL;
|
---|
118 | }
|
---|
119 |
|
---|
120 | len = PySequence_Fast_GET_SIZE(arg);
|
---|
121 | min_len = VISIBLE_SIZE_TP(type);
|
---|
122 | max_len = REAL_SIZE_TP(type);
|
---|
123 | n_unnamed_fields = UNNAMED_FIELDS_TP(type);
|
---|
124 |
|
---|
125 | if (min_len != max_len) {
|
---|
126 | if (len < min_len) {
|
---|
127 | PyErr_Format(PyExc_TypeError,
|
---|
128 | "%.500s() takes an at least %zd-sequence (%zd-sequence given)",
|
---|
129 | type->tp_name, min_len, len);
|
---|
130 | Py_DECREF(arg);
|
---|
131 | return NULL;
|
---|
132 | }
|
---|
133 |
|
---|
134 | if (len > max_len) {
|
---|
135 | PyErr_Format(PyExc_TypeError,
|
---|
136 | "%.500s() takes an at most %zd-sequence (%zd-sequence given)",
|
---|
137 | type->tp_name, max_len, len);
|
---|
138 | Py_DECREF(arg);
|
---|
139 | return NULL;
|
---|
140 | }
|
---|
141 | }
|
---|
142 | else {
|
---|
143 | if (len != min_len) {
|
---|
144 | PyErr_Format(PyExc_TypeError,
|
---|
145 | "%.500s() takes a %zd-sequence (%zd-sequence given)",
|
---|
146 | type->tp_name, min_len, len);
|
---|
147 | Py_DECREF(arg);
|
---|
148 | return NULL;
|
---|
149 | }
|
---|
150 | }
|
---|
151 |
|
---|
152 | res = (PyStructSequence*) PyStructSequence_New(type);
|
---|
153 | if (res == NULL) {
|
---|
154 | return NULL;
|
---|
155 | }
|
---|
156 | for (i = 0; i < len; ++i) {
|
---|
157 | PyObject *v = PySequence_Fast_GET_ITEM(arg, i);
|
---|
158 | Py_INCREF(v);
|
---|
159 | res->ob_item[i] = v;
|
---|
160 | }
|
---|
161 | for (; i < max_len; ++i) {
|
---|
162 | if (dict && (ob = PyDict_GetItemString(
|
---|
163 | dict, type->tp_members[i-n_unnamed_fields].name))) {
|
---|
164 | }
|
---|
165 | else {
|
---|
166 | ob = Py_None;
|
---|
167 | }
|
---|
168 | Py_INCREF(ob);
|
---|
169 | res->ob_item[i] = ob;
|
---|
170 | }
|
---|
171 |
|
---|
172 | Py_DECREF(arg);
|
---|
173 | return (PyObject*) res;
|
---|
174 | }
|
---|
175 |
|
---|
176 | static PyObject *
|
---|
177 | make_tuple(PyStructSequence *obj)
|
---|
178 | {
|
---|
179 | return structseq_slice(obj, 0, VISIBLE_SIZE(obj));
|
---|
180 | }
|
---|
181 |
|
---|
182 | static PyObject *
|
---|
183 | structseq_repr(PyStructSequence *obj)
|
---|
184 | {
|
---|
185 | PyObject *tup, *str;
|
---|
186 | tup = make_tuple(obj);
|
---|
187 | str = PyObject_Repr(tup);
|
---|
188 | Py_DECREF(tup);
|
---|
189 | return str;
|
---|
190 | }
|
---|
191 |
|
---|
192 | static PyObject *
|
---|
193 | structseq_concat(PyStructSequence *obj, PyObject *b)
|
---|
194 | {
|
---|
195 | PyObject *tup, *result;
|
---|
196 | tup = make_tuple(obj);
|
---|
197 | result = PySequence_Concat(tup, b);
|
---|
198 | Py_DECREF(tup);
|
---|
199 | return result;
|
---|
200 | }
|
---|
201 |
|
---|
202 | static PyObject *
|
---|
203 | structseq_repeat(PyStructSequence *obj, Py_ssize_t n)
|
---|
204 | {
|
---|
205 | PyObject *tup, *result;
|
---|
206 | tup = make_tuple(obj);
|
---|
207 | result = PySequence_Repeat(tup, n);
|
---|
208 | Py_DECREF(tup);
|
---|
209 | return result;
|
---|
210 | }
|
---|
211 |
|
---|
212 | static int
|
---|
213 | structseq_contains(PyStructSequence *obj, PyObject *o)
|
---|
214 | {
|
---|
215 | PyObject *tup;
|
---|
216 | int result;
|
---|
217 | tup = make_tuple(obj);
|
---|
218 | if (!tup)
|
---|
219 | return -1;
|
---|
220 | result = PySequence_Contains(tup, o);
|
---|
221 | Py_DECREF(tup);
|
---|
222 | return result;
|
---|
223 | }
|
---|
224 |
|
---|
225 | static long
|
---|
226 | structseq_hash(PyObject *obj)
|
---|
227 | {
|
---|
228 | PyObject *tup;
|
---|
229 | long result;
|
---|
230 | tup = make_tuple((PyStructSequence*) obj);
|
---|
231 | if (!tup)
|
---|
232 | return -1;
|
---|
233 | result = PyObject_Hash(tup);
|
---|
234 | Py_DECREF(tup);
|
---|
235 | return result;
|
---|
236 | }
|
---|
237 |
|
---|
238 | static PyObject *
|
---|
239 | structseq_richcompare(PyObject *obj, PyObject *o2, int op)
|
---|
240 | {
|
---|
241 | PyObject *tup, *result;
|
---|
242 | tup = make_tuple((PyStructSequence*) obj);
|
---|
243 | result = PyObject_RichCompare(tup, o2, op);
|
---|
244 | Py_DECREF(tup);
|
---|
245 | return result;
|
---|
246 | }
|
---|
247 |
|
---|
248 | static PyObject *
|
---|
249 | structseq_reduce(PyStructSequence* self)
|
---|
250 | {
|
---|
251 | PyObject* tup;
|
---|
252 | PyObject* dict;
|
---|
253 | PyObject* result;
|
---|
254 | Py_ssize_t n_fields, n_visible_fields, n_unnamed_fields;
|
---|
255 | int i;
|
---|
256 |
|
---|
257 | n_fields = REAL_SIZE(self);
|
---|
258 | n_visible_fields = VISIBLE_SIZE(self);
|
---|
259 | n_unnamed_fields = UNNAMED_FIELDS(self);
|
---|
260 | tup = PyTuple_New(n_visible_fields);
|
---|
261 | if (!tup) {
|
---|
262 | return NULL;
|
---|
263 | }
|
---|
264 |
|
---|
265 | dict = PyDict_New();
|
---|
266 | if (!dict) {
|
---|
267 | Py_DECREF(tup);
|
---|
268 | return NULL;
|
---|
269 | }
|
---|
270 |
|
---|
271 | for (i = 0; i < n_visible_fields; i++) {
|
---|
272 | Py_INCREF(self->ob_item[i]);
|
---|
273 | PyTuple_SET_ITEM(tup, i, self->ob_item[i]);
|
---|
274 | }
|
---|
275 |
|
---|
276 | for (; i < n_fields; i++) {
|
---|
277 | char *n = self->ob_type->tp_members[i-n_unnamed_fields].name;
|
---|
278 | PyDict_SetItemString(dict, n,
|
---|
279 | self->ob_item[i]);
|
---|
280 | }
|
---|
281 |
|
---|
282 | result = Py_BuildValue("(O(OO))", self->ob_type, tup, dict);
|
---|
283 |
|
---|
284 | Py_DECREF(tup);
|
---|
285 | Py_DECREF(dict);
|
---|
286 |
|
---|
287 | return result;
|
---|
288 | }
|
---|
289 |
|
---|
290 | static PySequenceMethods structseq_as_sequence = {
|
---|
291 | (lenfunc)structseq_length,
|
---|
292 | (binaryfunc)structseq_concat, /* sq_concat */
|
---|
293 | (ssizeargfunc)structseq_repeat, /* sq_repeat */
|
---|
294 | (ssizeargfunc)structseq_item, /* sq_item */
|
---|
295 | (ssizessizeargfunc)structseq_slice, /* sq_slice */
|
---|
296 | 0, /* sq_ass_item */
|
---|
297 | 0, /* sq_ass_slice */
|
---|
298 | (objobjproc)structseq_contains, /* sq_contains */
|
---|
299 | };
|
---|
300 |
|
---|
301 | static PyMethodDef structseq_methods[] = {
|
---|
302 | {"__reduce__", (PyCFunction)structseq_reduce,
|
---|
303 | METH_NOARGS, NULL},
|
---|
304 | {NULL, NULL}
|
---|
305 | };
|
---|
306 |
|
---|
307 | static PyTypeObject _struct_sequence_template = {
|
---|
308 | PyObject_HEAD_INIT(&PyType_Type)
|
---|
309 | 0, /* ob_size */
|
---|
310 | NULL, /* tp_name */
|
---|
311 | 0, /* tp_basicsize */
|
---|
312 | 0, /* tp_itemsize */
|
---|
313 | (destructor)structseq_dealloc, /* tp_dealloc */
|
---|
314 | 0, /* tp_print */
|
---|
315 | 0, /* tp_getattr */
|
---|
316 | 0, /* tp_setattr */
|
---|
317 | 0, /* tp_compare */
|
---|
318 | (reprfunc)structseq_repr, /* tp_repr */
|
---|
319 | 0, /* tp_as_number */
|
---|
320 | &structseq_as_sequence, /* tp_as_sequence */
|
---|
321 | 0, /* tp_as_mapping */
|
---|
322 | structseq_hash, /* tp_hash */
|
---|
323 | 0, /* tp_call */
|
---|
324 | 0, /* tp_str */
|
---|
325 | 0, /* tp_getattro */
|
---|
326 | 0, /* tp_setattro */
|
---|
327 | 0, /* tp_as_buffer */
|
---|
328 | Py_TPFLAGS_DEFAULT, /* tp_flags */
|
---|
329 | NULL, /* tp_doc */
|
---|
330 | 0, /* tp_traverse */
|
---|
331 | 0, /* tp_clear */
|
---|
332 | structseq_richcompare, /* tp_richcompare */
|
---|
333 | 0, /* tp_weaklistoffset */
|
---|
334 | 0, /* tp_iter */
|
---|
335 | 0, /* tp_iternext */
|
---|
336 | structseq_methods, /* tp_methods */
|
---|
337 | NULL, /* tp_members */
|
---|
338 | 0, /* tp_getset */
|
---|
339 | 0, /* tp_base */
|
---|
340 | 0, /* tp_dict */
|
---|
341 | 0, /* tp_descr_get */
|
---|
342 | 0, /* tp_descr_set */
|
---|
343 | 0, /* tp_dictoffset */
|
---|
344 | 0, /* tp_init */
|
---|
345 | 0, /* tp_alloc */
|
---|
346 | structseq_new, /* tp_new */
|
---|
347 | };
|
---|
348 |
|
---|
349 | void
|
---|
350 | PyStructSequence_InitType(PyTypeObject *type, PyStructSequence_Desc *desc)
|
---|
351 | {
|
---|
352 | PyObject *dict;
|
---|
353 | PyMemberDef* members;
|
---|
354 | int n_members, n_unnamed_members, i, k;
|
---|
355 |
|
---|
356 | #ifdef Py_TRACE_REFS
|
---|
357 | /* if the type object was chained, unchain it first
|
---|
358 | before overwriting its storage */
|
---|
359 | if (type->_ob_next) {
|
---|
360 | _Py_ForgetReference((PyObject*)type);
|
---|
361 | }
|
---|
362 | #endif
|
---|
363 |
|
---|
364 | n_unnamed_members = 0;
|
---|
365 | for (i = 0; desc->fields[i].name != NULL; ++i)
|
---|
366 | if (desc->fields[i].name == PyStructSequence_UnnamedField)
|
---|
367 | n_unnamed_members++;
|
---|
368 | n_members = i;
|
---|
369 |
|
---|
370 | memcpy(type, &_struct_sequence_template, sizeof(PyTypeObject));
|
---|
371 | type->tp_name = desc->name;
|
---|
372 | type->tp_doc = desc->doc;
|
---|
373 | type->tp_basicsize = sizeof(PyStructSequence)+
|
---|
374 | sizeof(PyObject*)*(n_members-1);
|
---|
375 | type->tp_itemsize = 0;
|
---|
376 |
|
---|
377 | members = PyMem_NEW(PyMemberDef, n_members-n_unnamed_members+1);
|
---|
378 | if (members == NULL)
|
---|
379 | return;
|
---|
380 |
|
---|
381 | for (i = k = 0; i < n_members; ++i) {
|
---|
382 | if (desc->fields[i].name == PyStructSequence_UnnamedField)
|
---|
383 | continue;
|
---|
384 | members[k].name = desc->fields[i].name;
|
---|
385 | members[k].type = T_OBJECT;
|
---|
386 | members[k].offset = offsetof(PyStructSequence, ob_item)
|
---|
387 | + i * sizeof(PyObject*);
|
---|
388 | members[k].flags = READONLY;
|
---|
389 | members[k].doc = desc->fields[i].doc;
|
---|
390 | k++;
|
---|
391 | }
|
---|
392 | members[k].name = NULL;
|
---|
393 |
|
---|
394 | type->tp_members = members;
|
---|
395 |
|
---|
396 | if (PyType_Ready(type) < 0)
|
---|
397 | return;
|
---|
398 | Py_INCREF(type);
|
---|
399 |
|
---|
400 | dict = type->tp_dict;
|
---|
401 | PyDict_SetItemString(dict, visible_length_key,
|
---|
402 | PyInt_FromLong((long) desc->n_in_sequence));
|
---|
403 | PyDict_SetItemString(dict, real_length_key,
|
---|
404 | PyInt_FromLong((long) n_members));
|
---|
405 | PyDict_SetItemString(dict, unnamed_fields_key,
|
---|
406 | PyInt_FromLong((long) n_unnamed_members));
|
---|
407 | }
|
---|