diff options
author | Chris Jerdonek <chris.jerdonek@gmail.com> | 2013-01-04 12:41:34 (GMT) |
---|---|---|
committer | Chris Jerdonek <chris.jerdonek@gmail.com> | 2013-01-04 12:41:34 (GMT) |
commit | 717e50e43aac255f64ccceace6d325f185ee8884 (patch) | |
tree | 70c66b69fe84aea87e4d3a7e808f2d7c5faf0e9e | |
parent | 830b4a85700cf2981e63e39c88169d2021019200 (diff) | |
download | cpython-717e50e43aac255f64ccceace6d325f185ee8884.zip cpython-717e50e43aac255f64ccceace6d325f185ee8884.tar.gz cpython-717e50e43aac255f64ccceace6d325f185ee8884.tar.bz2 |
Issue #16747: Reflow iterable glossary entry to match 3.x change e19ed347523e.
-rw-r--r-- | Doc/glossary.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 392a60c..198933b 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -378,17 +378,17 @@ Glossary slowly. See also :term:`interactive`. iterable - An object capable of returning its members one at a - time. Examples of iterables include all sequence types (such as - :class:`list`, :class:`str`, and :class:`tuple`) and some non-sequence - types like :class:`dict` and :class:`file` and objects of any classes you - define with an :meth:`__iter__` or :meth:`__getitem__` method. Iterables - can be used in a :keyword:`for` loop and in many other places where a - sequence is needed (:func:`zip`, :func:`map`, ...). When an iterable - object is passed as an argument to the built-in function :func:`iter`, it - returns an iterator for the object. This iterator is good for one pass - over the set of values. When using iterables, it is usually not necessary - to call :func:`iter` or deal with iterator objects yourself. The ``for`` + An object capable of returning its members one at a time. Examples of + iterables include all sequence types (such as :class:`list`, :class:`str`, + and :class:`tuple`) and some non-sequence types like :class:`dict` + and :class:`file` and objects of any classes you define + with an :meth:`__iter__` or :meth:`__getitem__` method. Iterables can be + used in a :keyword:`for` loop and in many other places where a sequence is + needed (:func:`zip`, :func:`map`, ...). When an iterable object is passed + as an argument to the built-in function :func:`iter`, it returns an + iterator for the object. This iterator is good for one pass over the set + of values. When using iterables, it is usually not necessary to call + :func:`iter` or deal with iterator objects yourself. The ``for`` statement does that automatically for you, creating a temporary unnamed variable to hold the iterator for the duration of the loop. See also :term:`iterator`, :term:`sequence`, and :term:`generator`. |