summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2011-06-25 13:00:14 (GMT)
committerRaymond Hettinger <python@rcn.com>2011-06-25 13:00:14 (GMT)
commit9d3df6d5080539c7c1ab792fdf9784fe3c30af5f (patch)
tree1bd0dfbc69d6d7be21ba9707fa9b9ce84b4ff4a8 /Doc
parenteceebeb14fdc1716c1d951a2ae8102eb80eaa87b (diff)
downloadcpython-9d3df6d5080539c7c1ab792fdf9784fe3c30af5f.zip
cpython-9d3df6d5080539c7c1ab792fdf9784fe3c30af5f.tar.gz
cpython-9d3df6d5080539c7c1ab792fdf9784fe3c30af5f.tar.bz2
Issue 11889: Clarify docs for enumerate.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/functions.rst15
1 files changed, 7 insertions, 8 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 1c1c167..b766a2e 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -331,14 +331,13 @@ are always available. They are listed here in alphabetical order.
:term:`iterator`, or some other object which supports iteration. The
:meth:`__next__` method of the iterator returned by :func:`enumerate` returns a
tuple containing a count (from *start* which defaults to 0) and the
- corresponding value obtained from iterating over *iterable*.
-
- >>> for i, season in enumerate('Spring Summer Fall Winter'.split(), start=1):
- print(i, season)
- 1 Spring
- 2 Summer
- 3 Fall
- 4 Winter
+ values obtained from iterating over *iterable*.
+
+ >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter']
+ >>> list(enumerate(seasons))
+ [(0, 'Spring'), (1, 'Summer'), (2, 'Fall'), (3, 'Winter')]
+ >>> list(enumerate(seasons, start=1))
+ [(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]
Equivalent to::