All 15 Functions & Scope questions
More in Functions & Scope
How do default parameter values work, and when are they evaluated? What does it mean that functions are 'first-class objects' in Python? What is Python's LEGB rule for variable scope resolution, and what does each letter stand for? Why do you need the 'global' keyword to MODIFY a global variable from inside a function, but not to simply READ it? How do *args and **kwargs let a function accept an arbitrary number of positional and keyword arguments? Why is using a mutable default argument (like an empty list) a classic Python bug, and how do you avoid it? How do keyword-only arguments (using a bare '*' in the parameter list) force certain parameters to be passed by name only? How do positional-only parameters (using a bare '/' in the parameter list, Python 3.8+) restrict how certain parameters can be passed? How does a closure capture variables from its enclosing scope, and what pitfall occurs when creating multiple closures inside a loop? How do you use functools.partial to create a new function with some arguments pre-filled?
Advertisement
Back to results for “Scope”
Python › Functions & Scope

How does the 'nonlocal' keyword let a nested function modify a variable in its ENCLOSING (not global) scope?

Intermediate

Answer

'nonlocal' tells Python that an assignment inside a nested function should modify the variable in the nearest ENCLOSING function's scope (not create a new local, and not reach all the way to global) — essential for implementing stateful closures, like a counter that persists across calls to an inner function.
def make_counter():
    count = 0
    def increment():
        nonlocal count  # modifies the ENCLOSING 'count', not global or a new local
        count += 1
        return count
    return increment

counter = make_counter()
print(counter())  # 1
print(counter())  # 2
Real-world example Building a stateful closure (like a counter or accumulator) where the inner function needs to persist and modify enclosing state across calls.

Common follow-ups: Why would 'global' NOT work correctly if used instead of 'nonlocal' in this exact scenario?

functools & Functional Programming Tools
All 15 Functions & Scope questions