SF bug #696777: How to make a class iterable using a member generator.

rhettinger · rhettinger · commit 2dd8c426382d · 2003-06-25T19:03:22.000Z
* Added a note that a container class can implement the iterator protocol
  by defining its __iter__() method as a generator.
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
@@ -395,6 +395,12 @@ \subsection{Iterator Types \label{typeiter}}
 was added in Python 2.3; in Python 2.2, various iterators are
 broken according to this rule.)
 
+Python's generators provide a convenient way to implement the
+iterator protocol.  If a container object's \method{__iter__()}
+method is implemented as a generator, it will automatically
+return an iterator object (technically, a generator object)
+supplying the \method{__iter__()} and \method{next()} methods.
+
 
 \subsection{Sequence Types \label{typesseq}}
 
