CKTIS / Python
UnboundLocalError — leitura de uma variável local não associada
UnboundLocalError ocorre quando uma função lê uma variável local à qual, nesse momento, não está associado qualquer valor. É uma subclasse de NameError; uma causa frequente é uma atribuição que oculta uma variável de um âmbito exterior.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
UnboundLocalErrorUnboundLocalError significa uma tentativa de ler uma variável local de uma função à qual não está associado qualquer valor nesse momento. É uma subclasse de NameError: um nome que não pode ser encontrado provoca NameError, enquanto este caso específico de uma variável local não associada provoca UnboundLocalError.
A atribuição a um nome dentro de uma função torna-o local em todo o corpo dessa função, a menos que se aplique uma declaração global ou nonlocal. Isto inclui uma atribuição num ramo que nunca é executado. No exemplo, count += 1 tem primeiro de ler a variável local count; não utiliza o count = 10 ao nível do módulo. A exceção interrompe a chamada, e o valor ao nível do módulo continua a ser 10.
Corrija a causa: garanta que é atribuído um valor antes de cada leitura possível, ou passe o valor como argumento e devolva o resultado. Se pretender voltar a associar um nome ao nível do módulo, utilize global; para uma associação existente na função envolvente mais próxima, utilize nonlocal. Coloque a declaração antes de utilizar o nome. No exemplo, apanhar a exceção serve para demonstrar o problema, não para corrigir o erro de âmbito.
Exemplos
count = 10
def increment():
count += 1
return count
try:
increment()
except UnboundLocalError as error:
print(type(error).__name__)
print(count)
Resultado
UnboundLocalError 10
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.