Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

UnboundLocalError — lettura di una variabile locale non associata

UnboundLocalError si verifica quando una funzione legge una variabile locale a cui in quel momento non è associato alcun valore. È una sottoclasse di NameError; una causa frequente è un’assegnazione che nasconde una variabile di uno scope esterno.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

UnboundLocalError

UnboundLocalError indica il tentativo di leggere una variabile locale di una funzione a cui in quel momento non è associato alcun valore. È una sottoclasse di NameError: un nome non trovato causa NameError, mentre questo caso specifico di variabile locale non associata causa UnboundLocalError.

L’assegnazione a un nome all’interno di una funzione lo rende locale nell’intero corpo della funzione, a meno che non si applichi una dichiarazione global o nonlocal. Questo vale anche per un’assegnazione in un ramo che non viene mai eseguito. Nell’esempio, count += 1 deve prima leggere la variabile locale count; non usa il count = 10 a livello di modulo. L’eccezione interrompe la chiamata e il valore a livello di modulo rimane 10.

Correggi la causa: assicurati che venga assegnato un valore prima di ogni possibile lettura, oppure passa il valore come argomento e restituisci il risultato. Se vuoi riassegnare un nome a livello di modulo, usa global; per un’associazione esistente nella funzione contenitore più vicina, usa nonlocal. Inserisci la dichiarazione prima di usare il nome. Nell’esempio, intercettare l’eccezione serve a mostrarla, non a correggere l’errore di scope.

Esempi

count = 10


def increment():
    count += 1
    return count


try:
    increment()
except UnboundLocalError as error:
    print(type(error).__name__)

print(count)

Risultato

UnboundLocalError
10

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti