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

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

UnboundLocalError

UnboundLocalError 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.

Fontes