All 15 functools & Functional Programming Tools questions
More in functools & Functional Programming Tools
How does functools.partial work and when is it useful? What does functools.reduce do, and why is it often discouraged in favor of loops? How does @functools.wraps preserve metadata when writing decorators? How does functools.total_ordering reduce boilerplate for comparison methods? What is the practical difference between using functools.reduce and a plain for-loop for accumulation? How does functools.singledispatch enable function overloading based on argument type? What is functools.cached_property and how does it differ from @property combined with manual caching? How do you clear or inspect the cache of an lru_cache-decorated function? Why is caution needed when applying @lru_cache directly to instance methods? How does functools.cmp_to_key bridge old-style comparison functions with Python 3's key-based sorting?
Advertisement
Back to results for “functools & Functional Programming Tools”
Python › functools & Functional Programming Tools

What does functools.reduce's initializer argument do, and why should you usually provide one?

Intermediate

Answer

The optional third argument to reduce serves as the starting accumulator value and is returned as-is if the iterable is empty. Without it, reduce raises TypeError on an empty iterable and uses the first element as the initial accumulator, which can produce subtly wrong results for operations that aren't naturally idempotent.
from functools import reduce

# Without initializer: fails on empty list
try:
    reduce(lambda a,b: a+b, [])
except TypeError as e:
    print('Error:', e)

# With initializer: safe
print(reduce(lambda a,b: a+b, [], 0))  # 0
Real-world example An analytics pipeline reducing a possibly-empty list of daily sales always passes 0 as the initializer to avoid crashing on days with no data.

Common follow-ups: What's the type of the initializer relative to the sequence elements?;How does reduce compare to itertools.accumulate?

Exception Handling;Comprehensions & Generators
All 15 functools & Functional Programming Tools questions