by returning an empty list instead of raising a TypeError.
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}
if i < 0 or i > 2: raise IndexError
return i + 4
self.assertEqual(zip(a, I()), t)
- self.assertRaises(TypeError, zip)
+ self.assertEqual(zip(), [])
+ self.assertEqual(zip(*[]), [])
self.assertRaises(TypeError, zip, None)
class G:
pass
# Test zip()'s use of iterators.
def test_builtin_zip(self):
- self.assertRaises(TypeError, zip)
+ self.assertEqual(zip(), [])
+ self.assertEqual(zip(*[]), [])
+ self.assertEqual(zip(*[(1, 2), 'ab']), [(1, 'a'), (2, 'b')])
+
self.assertRaises(TypeError, zip, None)
self.assertRaises(TypeError, zip, range(10), 42)
self.assertRaises(TypeError, zip, range(10), zip)
Core and builtins
-----------------
+- zip() with no arguments now returns an empty list instead of raising
+ a TypeError exception.
+
Extension modules
-----------------
PyObject *itlist; /* tuple of iterators */
int len; /* guess at result length */
- if (itemsize < 1) {
- PyErr_SetString(PyExc_TypeError,
- "zip() requires at least one sequence");
- return NULL;
- }
+ if (itemsize == 0)
+ return PyList_New(0);
+
/* args must be a tuple */
assert(PyTuple_Check(args));