1.. highlight:: c 2 3.. _iterator-objects: 4 5Iterator Objects 6---------------- 7 8Python provides two general-purpose iterator objects. The first, a sequence 9iterator, works with an arbitrary sequence supporting the :meth:`__getitem__` 10method. The second works with a callable object and a sentinel value, calling 11the callable for each item in the sequence, and ending the iteration when the 12sentinel value is returned. 13 14 15.. c:var:: PyTypeObject PySeqIter_Type 16 17 Type object for iterator objects returned by :c:func:`PySeqIter_New` and the 18 one-argument form of the :func:`iter` built-in function for built-in sequence 19 types. 20 21 22.. c:function:: int PySeqIter_Check(op) 23 24 Return true if the type of *op* is :c:data:`PySeqIter_Type`. This function 25 always succeeds. 26 27 28.. c:function:: PyObject* PySeqIter_New(PyObject *seq) 29 30 Return an iterator that works with a general sequence object, *seq*. The 31 iteration ends when the sequence raises :exc:`IndexError` for the subscripting 32 operation. 33 34 35.. c:var:: PyTypeObject PyCallIter_Type 36 37 Type object for iterator objects returned by :c:func:`PyCallIter_New` and the 38 two-argument form of the :func:`iter` built-in function. 39 40 41.. c:function:: int PyCallIter_Check(op) 42 43 Return true if the type of *op* is :c:data:`PyCallIter_Type`. This 44 function always succeeds. 45 46 47.. c:function:: PyObject* PyCallIter_New(PyObject *callable, PyObject *sentinel) 48 49 Return a new iterator. The first parameter, *callable*, can be any Python 50 callable object that can be called with no parameters; each call to it should 51 return the next item in the iteration. When *callable* returns a value equal to 52 *sentinel*, the iteration will be terminated. 53