blob: 8b2e6e116ba10861b49af06f19f78e8559351aaf [file] [log] [blame]
Guido van Rossum7dab2422002-04-26 19:40:56 +00001/* enumerate object */
2
3#include "Python.h"
4
5typedef struct {
6 PyObject_HEAD
7 long en_index; /* current index of enumeration */
8 PyObject* en_sit; /* secondary iterator of enumeration */
Raymond Hettingere8b0f042003-05-28 14:05:34 +00009 PyObject* en_result; /* result tuple */
Guido van Rossum7dab2422002-04-26 19:40:56 +000010} enumobject;
11
12PyTypeObject PyEnum_Type;
13
14static PyObject *
15enum_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
16{
17 enumobject *en;
18 PyObject *seq = NULL;
19 static char *kwlist[] = {"sequence", 0};
20
21 if (!PyArg_ParseTupleAndKeywords(args, kwds, "O:enumerate", kwlist,
22 &seq))
23 return NULL;
24
25 en = (enumobject *)type->tp_alloc(type, 0);
26 if (en == NULL)
27 return NULL;
28 en->en_index = 0;
29 en->en_sit = PyObject_GetIter(seq);
30 if (en->en_sit == NULL) {
31 Py_DECREF(en);
32 return NULL;
33 }
Raymond Hettinger54a831b2003-11-02 05:37:44 +000034 en->en_result = PyTuple_Pack(2, Py_None, Py_None);
Raymond Hettingere8b0f042003-05-28 14:05:34 +000035 if (en->en_result == NULL) {
36 Py_DECREF(en->en_sit);
37 Py_DECREF(en);
38 return NULL;
39 }
Guido van Rossum7dab2422002-04-26 19:40:56 +000040 return (PyObject *)en;
41}
42
43static void
44enum_dealloc(enumobject *en)
45{
46 PyObject_GC_UnTrack(en);
47 Py_XDECREF(en->en_sit);
Raymond Hettingere8b0f042003-05-28 14:05:34 +000048 Py_XDECREF(en->en_result);
Guido van Rossum7dab2422002-04-26 19:40:56 +000049 en->ob_type->tp_free(en);
50}
51
52static int
53enum_traverse(enumobject *en, visitproc visit, void *arg)
54{
Raymond Hettingere8b0f042003-05-28 14:05:34 +000055 int err;
56
57 if (en->en_sit) {
58 err = visit(en->en_sit, arg);
59 if (err)
60 return err;
61 }
62 if (en->en_result) {
63 err = visit(en->en_result, arg);
64 if (err)
65 return err;
66 }
Guido van Rossum7dab2422002-04-26 19:40:56 +000067 return 0;
68}
69
70static PyObject *
71enum_next(enumobject *en)
72{
Guido van Rossum7dab2422002-04-26 19:40:56 +000073 PyObject *next_index;
Guido van Rossumca5ed5b2002-07-16 21:02:42 +000074 PyObject *next_item;
Raymond Hettingere8b0f042003-05-28 14:05:34 +000075 PyObject *result = en->en_result;
76 PyObject *it = en->en_sit;
Guido van Rossum7dab2422002-04-26 19:40:56 +000077
Raymond Hettingere8b0f042003-05-28 14:05:34 +000078 next_item = (*it->ob_type->tp_iternext)(it);
79 if (next_item == NULL)
Guido van Rossumca5ed5b2002-07-16 21:02:42 +000080 return NULL;
81
82 next_index = PyInt_FromLong(en->en_index);
83 if (next_index == NULL) {
Raymond Hettingere8b0f042003-05-28 14:05:34 +000084 Py_DECREF(next_item);
Guido van Rossum7dab2422002-04-26 19:40:56 +000085 return NULL;
86 }
Raymond Hettingere8b0f042003-05-28 14:05:34 +000087 en->en_index++;
88
89 if (result->ob_refcnt == 1) {
90 Py_INCREF(result);
91 Py_DECREF(PyTuple_GET_ITEM(result, 0));
92 Py_DECREF(PyTuple_GET_ITEM(result, 1));
93 } else {
94 result = PyTuple_New(2);
95 if (result == NULL) {
96 Py_DECREF(next_index);
97 Py_DECREF(next_item);
98 return NULL;
99 }
100 }
Guido van Rossumca5ed5b2002-07-16 21:02:42 +0000101 PyTuple_SET_ITEM(result, 0, next_index);
Guido van Rossum7dab2422002-04-26 19:40:56 +0000102 PyTuple_SET_ITEM(result, 1, next_item);
103 return result;
104}
105
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000106PyDoc_STRVAR(enum_doc,
Jeremy Hyltonfbbe3472003-04-21 20:26:25 +0000107"enumerate(iterable) -> iterator for index, value of iterable\n"
108"\n"
109"Return an enumerate object. iterable must be an other object that supports\n"
110"iteration. The enumerate object yields pairs containing a count (from\n"
111"zero) and a value yielded by the iterable argument. enumerate is useful\n"
112"for obtaining an indexed list: (0, seq[0]), (1, seq[1]), (2, seq[2]), ...");
Guido van Rossum7dab2422002-04-26 19:40:56 +0000113
114PyTypeObject PyEnum_Type = {
115 PyObject_HEAD_INIT(&PyType_Type)
116 0, /* ob_size */
117 "enumerate", /* tp_name */
118 sizeof(enumobject), /* tp_basicsize */
119 0, /* tp_itemsize */
120 /* methods */
121 (destructor)enum_dealloc, /* tp_dealloc */
122 0, /* tp_print */
123 0, /* tp_getattr */
124 0, /* tp_setattr */
125 0, /* tp_compare */
126 0, /* tp_repr */
127 0, /* tp_as_number */
128 0, /* tp_as_sequence */
129 0, /* tp_as_mapping */
130 0, /* tp_hash */
131 0, /* tp_call */
132 0, /* tp_str */
133 PyObject_GenericGetAttr, /* tp_getattro */
134 0, /* tp_setattro */
135 0, /* tp_as_buffer */
136 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
137 Py_TPFLAGS_BASETYPE, /* tp_flags */
138 enum_doc, /* tp_doc */
139 (traverseproc)enum_traverse, /* tp_traverse */
140 0, /* tp_clear */
141 0, /* tp_richcompare */
142 0, /* tp_weaklistoffset */
Raymond Hettinger1da1dbf2003-03-17 19:46:11 +0000143 PyObject_SelfIter, /* tp_iter */
Guido van Rossum7dab2422002-04-26 19:40:56 +0000144 (iternextfunc)enum_next, /* tp_iternext */
Guido van Rossumca5ed5b2002-07-16 21:02:42 +0000145 0, /* tp_methods */
Guido van Rossum7dab2422002-04-26 19:40:56 +0000146 0, /* tp_members */
147 0, /* tp_getset */
148 0, /* tp_base */
149 0, /* tp_dict */
150 0, /* tp_descr_get */
151 0, /* tp_descr_set */
152 0, /* tp_dictoffset */
153 0, /* tp_init */
154 PyType_GenericAlloc, /* tp_alloc */
155 enum_new, /* tp_new */
156 PyObject_GC_Del, /* tp_free */
157};
Raymond Hettinger85c20a42003-11-06 14:06:48 +0000158
159/* Reversed Object ***************************************************************/
160
161typedef struct {
162 PyObject_HEAD
163 long index;
164 PyObject* seq;
165} reversedobject;
166
167static PyObject *
168reversed_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
169{
170 long n;
171 PyObject *seq;
172 reversedobject *ro;
173
174 if (!PyArg_UnpackTuple(args, "reversed", 1, 1, &seq))
175 return NULL;
176
Raymond Hettinger1021c442003-11-07 15:38:09 +0000177 /* Special case optimization for xrange and lists */
178 if (PyRange_Check(seq) || PyList_Check(seq))
Raymond Hettinger85c20a42003-11-06 14:06:48 +0000179 return PyObject_CallMethod(seq, "__reversed__", NULL);
180
181 if (!PySequence_Check(seq)) {
182 PyErr_SetString(PyExc_TypeError,
183 "argument to reversed() must be a sequence");
184 return NULL;
185 }
186
187 n = PySequence_Size(seq);
188 if (n == -1)
189 return NULL;
190
191 ro = (reversedobject *)type->tp_alloc(type, 0);
192 if (ro == NULL)
193 return NULL;
194
195 ro->index = n-1;
196 Py_INCREF(seq);
197 ro->seq = seq;
198 return (PyObject *)ro;
199}
200
201static void
202reversed_dealloc(reversedobject *ro)
203{
204 PyObject_GC_UnTrack(ro);
205 Py_XDECREF(ro->seq);
206 ro->ob_type->tp_free(ro);
207}
208
209static int
210reversed_traverse(reversedobject *ro, visitproc visit, void *arg)
211{
212 if (ro->seq)
213 return visit((PyObject *)(ro->seq), arg);
214 return 0;
215}
216
217static PyObject *
218reversed_next(reversedobject *ro)
219{
220 PyObject *item;
221
222 if (ro->index < 0)
223 return NULL;
224
225 assert(PySequence_Check(ro->seq));
226 item = PySequence_GetItem(ro->seq, ro->index);
227 if (item == NULL)
228 return NULL;
229
230 ro->index--;
231 return item;
232}
233
234PyDoc_STRVAR(reversed_doc,
235"reverse(sequence) -> reverse iterator over values of the sequence\n"
236"\n"
237"Return a reverse iterator");
238
239PyTypeObject PyReversed_Type = {
240 PyObject_HEAD_INIT(&PyType_Type)
241 0, /* ob_size */
242 "reversed", /* tp_name */
243 sizeof(reversedobject), /* tp_basicsize */
244 0, /* tp_itemsize */
245 /* methods */
246 (destructor)reversed_dealloc, /* tp_dealloc */
247 0, /* tp_print */
248 0, /* tp_getattr */
249 0, /* tp_setattr */
250 0, /* tp_compare */
251 0, /* tp_repr */
252 0, /* tp_as_number */
253 0, /* tp_as_sequence */
254 0, /* tp_as_mapping */
255 0, /* tp_hash */
256 0, /* tp_call */
257 0, /* tp_str */
258 PyObject_GenericGetAttr, /* tp_getattro */
259 0, /* tp_setattro */
260 0, /* tp_as_buffer */
261 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC |
262 Py_TPFLAGS_BASETYPE, /* tp_flags */
263 reversed_doc, /* tp_doc */
264 (traverseproc)reversed_traverse,/* tp_traverse */
265 0, /* tp_clear */
266 0, /* tp_richcompare */
267 0, /* tp_weaklistoffset */
268 PyObject_SelfIter, /* tp_iter */
269 (iternextfunc)reversed_next, /* tp_iternext */
270 0, /* tp_methods */
271 0, /* tp_members */
272 0, /* tp_getset */
273 0, /* tp_base */
274 0, /* tp_dict */
275 0, /* tp_descr_get */
276 0, /* tp_descr_set */
277 0, /* tp_dictoffset */
278 0, /* tp_init */
279 PyType_GenericAlloc, /* tp_alloc */
280 reversed_new, /* tp_new */
281 PyObject_GC_Del, /* tp_free */
282};