Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Palavra-chave nonlocal

Identifica a ligação existente mais próxima numa função envolvente e permite atribuir-lhe outro valor.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

nonlocal total

Identifica a ligação existente mais próxima numa função envolvente e permite atribuir-lhe outro valor.

Uma função interna devolvida conserva essa ligação entre chamadas. Uma variável do módulo por si só não basta e a ausência da ligação envolvente provoca SyntaxError na compilação.

Cada chamada à função exterior cria um contador independente.

Exemplos

def counter(start):
    total = start
    def next_value():
        nonlocal total
        total += 1
        return total
    return next_value
a, b = counter(0), counter(7)
print(a(), a(), b())
try:
    compile("def bad():\n    nonlocal absent", "<example>", "exec")
except SyntaxError:
    print("missing binding")

Resultado

1 2 8
missing binding

Cada chamada à função exterior cria um contador independente.

Fontes