UnboundLocalError: cannot access local variable 'contor' where it is not associated with a value
În funcție modifici o variabilă din afara ei (de exemplu `contor += 1`), iar Python o consideră locală funcției, deci fără valoare încă. Trimite valoarea ca parametru și returnează rezultatul sau, dacă chiar vrei variabila globală, declar-o cu `global`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Regula lui Python: dacă într-o funcție atribui o valoare unui nume (x = ..., x += 1), acel nume devine variabilă locală pentru toată funcția, chiar și pe liniile de dinaintea atribuirii. Când citești variabila înainte ca ea să primească valoare în funcție, Python nu se uită la variabila cu același nume din afară, ci dă UnboundLocalError.
Mesajul cannot access local variable 'contor' where it is not associated with a value înseamnă: contor e locală aici, dar în momentul ăsta nu are încă nicio valoare. Cazul clasic este contor += 1 într-o funcție, unde contor a fost definit în afara ei: += înseamnă citește și apoi scrie, iar citirea eșuează. În versiunile mai vechi mesajul era local variable 'contor' referenced before assignment.
De ce apare: cauzele frecvente
1+= pe o variabilă globală
vizite = 0
def inregistreaza():
vizite += 1
inregistreaza()vizite = 0
def inregistreaza(vizite):
return vizite + 1
vizite = inregistreaza(vizite)vizite += 1 face din vizite o variabilă locală, care nu are valoare la citire. Varianta corectă primește valoarea ca parametru și o returnează.
2Variabila primește valoare doar pe o ramură
def calificativ(nota):
if nota >= 5:
rezultat = "admis"
return rezultat
print(calificativ(3))def calificativ(nota):
rezultat = "respins"
if nota >= 5:
rezultat = "admis"
return rezultat
print(calificativ(3))Pentru nota 3, ramura if nu rulează și rezultat nu primește valoare. O valoare inițială acoperă toate cazurile.
3Funcție interioară care modifică variabila funcției exterioare
def numarator():
n = 0
def pas():
n += 1
return n
return pasdef numarator():
n = 0
def pas():
nonlocal n
n += 1
return n
return pasnonlocal n îi spune lui Python că n e variabila funcției exterioare, nu una locală nouă.
Repară eroarea, direct în pagină
Codul de mai jos dă UnboundLocalError la primul apel al funcției. Repară funcția adauga_in_cos ca să primească numărul curent de produse ca parametru și să returneze numărul nou. Programul trebuie să afișeze Produse în coș: 3.
produse = 0
def adauga_in_cos():
produse += 1
adauga_in_cos()
adauga_in_cos()
adauga_in_cos()
print("Produse în coș:", produse)Produse în coș: 3
Indiciu
Funcția să primească produse ca parametru și să întoarcă produse + 1; la apel, salvează rezultatul înapoi în variabilă.
Reparația
produse = 0
def adauga_in_cos(produse):
return produse + 1
produse = adauga_in_cos(produse)
produse = adauga_in_cos(produse)
produse = adauga_in_cos(produse)
print("Produse în coș:", produse)De ce merge
Linia produse += 1 din funcție face din produse o variabilă locală, iar la citire ea nu are încă nicio valoare, de unde UnboundLocalError. În varianta corectă, funcția primește valoarea curentă ca parametru și returnează valoarea nouă, iar apelul o salvează în variabila din afară. Funcția nu mai depinde de o variabilă globală și poate fi testată separat. O alternativă ar fi global produse la începutul funcției.
Alte forme ale mesajului
UnboundLocalError: local variable 'contor' referenced before assignmentNameError: cannot access free variable 'n' where it is not associated with a value in enclosing scope
Cum o eviți pe viitor
- Preferă funcțiile care primesc date prin parametri și dau rezultatul cu
return, în locul celor care modifică variabile globale. - Dă variabilelor o valoare inițială la începutul funcției, înainte de
if-uri și bucle. - Folosește
globalsaunonlocaldoar când chiar ai nevoie să modifici variabila din afară, și cu măsură.
Întrebări frecvente
De ce pot citi variabila globală, dar nu o pot modifica?
Dacă doar citești contor în funcție, Python o caută în afară și o găsește. În clipa în care există o atribuire către contor oriunde în funcție, Python o tratează ca locală în toată funcția, iar citirea de dinainte eșuează.
E bine să folosesc global?
Funcționează, dar face codul greu de urmărit și de testat, pentru că orice funcție poate schimba variabila. Pentru programe mici e acceptabil; în general e mai curat să returnezi valoarea nouă sau să o ții într-un obiect.
Erori înrudite
NameError: name 'total' is not defined Folosești un nume (variabilă, funcție sau modul) pe care Python nu îl cunoaște în acel loc: e scris greșit, nu i-ai dat încă o valoare sau există doar în interiorul unei funcții. Verifică scrierea exactă și ordinea liniilor. RecursionError: maximum recursion depth exceeded O funcție se apelează pe ea însăși de prea multe ori, de obicei la nesfârșit, pentru că lipsește cazul de bază sau apelul recursiv nu se apropie de el. Verifică condiția de oprire și că argumentul scade (sau crește) spre ea la fiecare apel. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
