summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2003-08-02 07:42:57 (GMT)
committerRaymond Hettinger <python@rcn.com>2003-08-02 07:42:57 (GMT)
commiteaef61511656071194565878dc80c46096d46415 (patch)
treeb3e761f4c79ace0c0baeeb3ed845afd14ca666bb /Doc
parent9463792c686c312dcf85c649b7183eae25403945 (diff)
downloadcpython-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')
-rw-r--r--Doc/lib/libfuncs.tex12
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}