Iterator Objects

Python provides two general-purpose iterator objects. The first, a sequence iterator, works with an arbitrary sequence supporting the __getitem__() method. The second works with a callable object and a sentinel value, calling the callable for each item in the sequence, and ending the iteration when the sentinel value is returned.

PyTypeObject PySeqIter_Type
Μέρος του Σταθερό ABI.

Type object for iterator objects returned by PySeqIter_New() and the one-argument form of the iter() built-in function for built-in sequence types.

int PySeqIter_Check(PyObject *op)

Return true if the type of op is PySeqIter_Type. This function always succeeds.

PyObject *PySeqIter_New(PyObject *seq)
Επιστρεφόμενη τιμή: New reference. Μέρος του Σταθερό ABI.

Return an iterator that works with a general sequence object, seq. The iteration ends when the sequence raises IndexError for the subscripting operation.

PyTypeObject PyCallIter_Type
Μέρος του Σταθερό ABI.

Type object for iterator objects returned by PyCallIter_New() and the two-argument form of the iter() built-in function.

int PyCallIter_Check(PyObject *op)

Return true if the type of op is PyCallIter_Type. This function always succeeds.

PyObject *PyCallIter_New(PyObject *callable, PyObject *sentinel)
Επιστρεφόμενη τιμή: New reference. Μέρος του Σταθερό ABI.

Return a new iterator. The first parameter, callable, can be any Python callable object that can be called with no parameters; each call to it should return the next item in the iteration. When callable returns a value equal to sentinel, the iteration will be terminated.

Other Iterator Objects

PyTypeObject PyByteArrayIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyBytesIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyListIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyListRevIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PySetIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyTupleIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyRangeIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyLongRangeIter_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyDictIterKey_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyDictRevIterKey_Type
Μέρος του Σταθερό ABI από την έκδοση 3.8.
PyTypeObject PyDictIterValue_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyDictRevIterValue_Type
Μέρος του Σταθερό ABI από την έκδοση 3.8.
PyTypeObject PyDictIterItem_Type
Μέρος του Σταθερό ABI.
PyTypeObject PyDictRevIterItem_Type
Μέρος του Σταθερό ABI από την έκδοση 3.8.

Type objects for iterators of various built-in objects.

Do not create instances of these directly; prefer calling PyObject_GetIter() instead.

Note that there is no guarantee that a given built-in type uses a given iterator type. For example, iterating over range will use one of two iterator types depending on the size of the range. Other types may start using a similar scheme in the future, without warning.