]> granicus.if.org Git - python/commitdiff
SF bug #821701: reduce docs neglect a very important piece of information.
authorRaymond Hettinger <python@rcn.com>
Mon, 13 Oct 2003 17:52:35 +0000 (17:52 +0000)
committerRaymond Hettinger <python@rcn.com>
Mon, 13 Oct 2003 17:52:35 +0000 (17:52 +0000)
Add a note showing which argument is the accumulator.

Doc/lib/libfuncs.tex

index 936a02323482f7d2b57c3396312c77897dad2230..a9f3a65a70245140e051a669b88850d4926105d0 100644 (file)
@@ -816,7 +816,9 @@ class C(object):
   Apply \var{function} of two arguments cumulatively to the items of
   \var{sequence}, from left to right, so as to reduce the sequence to
   a single value.  For example, \code{reduce(lambda x, y: x+y, [1, 2,
-  3, 4, 5])} calculates \code{((((1+2)+3)+4)+5)}.  If the optional
+  3, 4, 5])} calculates \code{((((1+2)+3)+4)+5)}.  The left argument,
+  \var{x}, is the accumulated value and the right argument, \var{y},
+  is the update value from the \var{sequence}.  If the optional
   \var{initializer} is present, it is placed before the items of the
   sequence in the calculation, and serves as a default when the
   sequence is empty.  If \var{initializer} is not given and