diff options
author | Raymond Hettinger <python@rcn.com> | 2003-08-02 07:42:57 (GMT) |
---|---|---|
committer | Raymond Hettinger <python@rcn.com> | 2003-08-02 07:42:57 (GMT) |
commit | eaef61511656071194565878dc80c46096d46415 (patch) | |
tree | b3e761f4c79ace0c0baeeb3ed845afd14ca666bb /Doc/lib/libfuncs.tex | |
parent | 9463792c686c312dcf85c649b7183eae25403945 (diff) | |
download | cpython-eaef61511656071194565878dc80c46096d46415.zip cpython-eaef61511656071194565878dc80c46096d46415.tar.gz cpython-eaef61511656071194565878dc80c46096d46415.tar.bz2 |
As discussed on python-dev, changed builtin.zip() to handle zero arguments
by returning an empty list instead of raising a TypeError.
Diffstat (limited to 'Doc/lib/libfuncs.tex')
-rw-r--r-- | Doc/lib/libfuncs.tex | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index b9dc4e1..2f1ffff 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -1063,14 +1063,18 @@ It's a function when the loop is usually terminated with \keyword{break}). \end{funcdesc} -\begin{funcdesc}{zip}{seq1, \moreargs} +\begin{funcdesc}{zip}{\optional{seq1, \moreargs}} This function returns a list of tuples, where the \var{i}-th tuple contains - the \var{i}-th element from each of the argument sequences. At - least one sequence is required, otherwise a \exception{TypeError} is - raised. The returned list is truncated in length to the length of + the \var{i}-th element from each of the argument sequences. + The returned list is truncated in length to the length of the shortest argument sequence. When there are multiple argument sequences which are all of the same length, \function{zip()} is similar to \function{map()} with an initial argument of \code{None}. With a single sequence argument, it returns a list of 1-tuples. + With no arguments, it returns an empty list. \versionadded{2.0} + + \versionchanged[Formerly, \function{zip()} required at least one argument + and \code{zip()} raised a \exception{TypeError} instead of returning + \code{[]}]{2.4} \end{funcdesc} |