mirror of https://github.com/python/cpython
Align functools.reduce() docstring with PEP-257 (#126045)
Yak-shave in preparation for Argument Clinic adaption in gh-125999.
This commit is contained in:
parent
aeafaf4cda
commit
9b14083497
|
@ -238,12 +238,14 @@ def reduce(function, sequence, initial=_initial_missing):
|
|||
"""
|
||||
reduce(function, iterable[, initial], /) -> value
|
||||
|
||||
Apply a function of two arguments cumulatively to the items of a sequence
|
||||
or iterable, from left to right, so as to reduce the iterable to a single
|
||||
value. For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
|
||||
((((1+2)+3)+4)+5). If initial is present, it is placed before the items
|
||||
of the iterable in the calculation, and serves as a default when the
|
||||
iterable is empty.
|
||||
Apply a function of two arguments cumulatively to the items of an iterable, from left to right.
|
||||
|
||||
This effectively reduces the iterable to a single value. If initial is present,
|
||||
it is placed before the items of the iterable in the calculation, and serves as
|
||||
a default when the iterable is empty.
|
||||
|
||||
For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])
|
||||
calculates ((((1 + 2) + 3) + 4) + 5).
|
||||
"""
|
||||
|
||||
it = iter(sequence)
|
||||
|
|
|
@ -1009,12 +1009,14 @@ Fail:
|
|||
PyDoc_STRVAR(functools_reduce_doc,
|
||||
"reduce(function, iterable[, initial], /) -> value\n\
|
||||
\n\
|
||||
Apply a function of two arguments cumulatively to the items of a sequence\n\
|
||||
or iterable, from left to right, so as to reduce the iterable to a single\n\
|
||||
value. For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates\n\
|
||||
((((1+2)+3)+4)+5). If initial is present, it is placed before the items\n\
|
||||
of the iterable in the calculation, and serves as a default when the\n\
|
||||
iterable is empty.");
|
||||
Apply a function of two arguments cumulatively to the items of an iterable, from left to right.\n\
|
||||
\n\
|
||||
This effectively reduces the iterable to a single value. If initial is present,\n\
|
||||
it is placed before the items of the iterable in the calculation, and serves as\n\
|
||||
a default when the iterable is empty.\n\
|
||||
\n\
|
||||
For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5])\n\
|
||||
calculates ((((1 + 2) + 3) + 4) + 5).");
|
||||
|
||||
/* lru_cache object **********************************************************/
|
||||
|
||||
|
|
Loading…
Reference in New Issue