Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Fix merge glitch.

This commit is contained in:
Georg Brandl 2008-01-24 23:34:34 +00:00
parent e7a15bb808
commit b267384098
1 changed files with 0 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Doc/library/itertools.rst
View File

@ -259,22 +259,9 @@ loops that truncate the stream.
makes possible an idiom for clustering a data series into n-length groups makes possible an idiom for clustering a data series into n-length groups
using ``izip(*[iter(s)]*n)``. using ``izip(*[iter(s)]*n)``.
<<<<<<< .working
Note, when :func:`izip` is used with unequal length inputs, subsequent
iteration over the longer iterables cannot reliably be continued after
:func:`izip` terminates. Potentially, up to one entry will be missing from
each of the left-over iterables. This occurs because a value is fetched from
each iterator in- turn, but the process ends when one of the iterators
terminates. This leaves the last fetched values in limbo (they cannot be
returned in a final, incomplete tuple and they are cannot be pushed back into
the iterator for retrieval with ``next(it)``). In general, :func:`izip`
should only be used with unequal length inputs when you don't care about
trailing, unmatched values from the longer iterables.
=======
:func:`izip` should only be used with unequal length inputs when you don't :func:`izip` should only be used with unequal length inputs when you don't
care about trailing, unmatched values from the longer iterables. If those care about trailing, unmatched values from the longer iterables. If those
values are important, use :func:`izip_longest` instead. values are important, use :func:`izip_longest` instead.
>>>>>>> .merge-right.r60208
.. function:: izip_longest(*iterables[, fillvalue]) .. function:: izip_longest(*iterables[, fillvalue])