From: Andrew M. Kuchling Date: Wed, 20 Dec 2006 19:57:10 +0000 (+0000) Subject: [Bug #1619674] Make sum() use the term iterable, not sequence X-Git-Tag: v2.6a1~2349 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1be2ac9cd6e72dd5116a24d173b66f9ae4ec51f0;p=python [Bug #1619674] Make sum() use the term iterable, not sequence --- diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index dc52915c92..4f41002508 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -1087,11 +1087,11 @@ class C: string, \code{''}. \end{funcdesc} -\begin{funcdesc}{sum}{sequence\optional{, start}} - Sums \var{start} and the items of a \var{sequence}, from left to - right, and returns the total. \var{start} defaults to \code{0}. - The \var{sequence}'s items are normally numbers, and are not allowed - to be strings. The fast, correct way to concatenate sequence of +\begin{funcdesc}{sum}{iterable\optional{, start}} + Sums \var{start} and the items of an \var{iterable} from left to + right and returns the total. \var{start} defaults to \code{0}. + The \var{iterable}'s items are normally numbers, and are not allowed + to be strings. The fast, correct way to concatenate a sequence of strings is by calling \code{''.join(\var{sequence})}. Note that \code{sum(range(\var{n}), \var{m})} is equivalent to \code{reduce(operator.add, range(\var{n}), \var{m})}