mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-11 14:44:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue #23695: Explain the zip() example for clustering a data series into n-length groups.

Browse source
This commit is contained in:
Raymond Hettinger 2015-05-13 02:34:38 -07:00
parent 2f3742b0d8
commit 0907a45eb1
1 changed files with 3 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

4
Doc/library/functions.rst
View file

@ -1492,7 +1492,9 @@ are always available. They are listed here in alphabetical order.
The left-to-right evaluation order of the iterables is guaranteed. This The left-to-right evaluation order of the iterables is guaranteed. This
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 ``zip(*[iter(s)]*n)``. using ``zip(*[iter(s)]*n)``. This repeats the *same* iterator ``n`` times
so that each output tuple has the result of ``n`` calls to the iterator.
This has the effect of dividing the input into n-length chunks.
:func:`zip` should only be used with unequal length inputs when you don't :func:`zip` 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