--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/symbian-qemu-0.9.1-12/python-2.6.1/Doc/c-api/iterator.rst Fri Jul 31 15:01:17 2009 +0100
@@ -0,0 +1,62 @@
+.. highlightlang:: c
+
+.. _iterator-objects:
+
+Iterator Objects
+----------------
+
+Python provides two general-purpose iterator objects. The first, a sequence
+iterator, works with an arbitrary sequence supporting the :meth:`__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.
+
+
+.. cvar:: PyTypeObject PySeqIter_Type
+
+ Type object for iterator objects returned by :cfunc:`PySeqIter_New` and the
+ one-argument form of the :func:`iter` built-in function for built-in sequence
+ types.
+
+ .. versionadded:: 2.2
+
+
+.. cfunction:: int PySeqIter_Check(op)
+
+ Return true if the type of *op* is :cdata:`PySeqIter_Type`.
+
+ .. versionadded:: 2.2
+
+
+.. cfunction:: PyObject* PySeqIter_New(PyObject *seq)
+
+ Return an iterator that works with a general sequence object, *seq*. The
+ iteration ends when the sequence raises :exc:`IndexError` for the subscripting
+ operation.
+
+ .. versionadded:: 2.2
+
+
+.. cvar:: PyTypeObject PyCallIter_Type
+
+ Type object for iterator objects returned by :cfunc:`PyCallIter_New` and the
+ two-argument form of the :func:`iter` built-in function.
+
+ .. versionadded:: 2.2
+
+
+.. cfunction:: int PyCallIter_Check(op)
+
+ Return true if the type of *op* is :cdata:`PyCallIter_Type`.
+
+ .. versionadded:: 2.2
+
+
+.. cfunction:: PyObject* PyCallIter_New(PyObject *callable, PyObject *sentinel)
+
+ 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.
+
+ .. versionadded:: 2.2