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