SyntaxError: no binding for nonlocal 'contor' found
Ai scris nonlocal contor într-o funcție interioară, dar funcția exterioară nu are nicio variabilă contor. nonlocal leagă doar de variabile ale unei funcții care o conține; pentru o variabilă de la nivelul fișierului, folosește global sau, mai bine, returnează valoarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
nonlocal x îi spune lui Python: „x din funcția asta e variabila x din funcția care mă conține”. Ca să funcționeze, trebuie să existe o funcție exterioară (nu nivelul modulului) care să atribuie x. Dacă nu există, legătura nu are unde să se facă și Python refuză fișierul: no binding for nonlocal 'contor' found.
Eroarea apare la compilare, deci înainte de rulare, la linia cu nonlocal. Cauze tipice: variabila e definită la nivelul fișierului (atunci ai nevoie de global, nu nonlocal), variabila e creată în funcția exterioară abia după funcția interioară sau deloc, ori ai scris nonlocal într-o funcție care nu e imbricată.
Înrudită: nonlocal declaration not allowed at module level, când scrii nonlocal direct în fișier.
De ce apare: cauzele frecvente
1Variabila e globală, nu a unei funcții exterioare
contor = 0
def apasa():
nonlocal contor
contor += 1contor = 0
def apasa():
global contor
contor += 1
apasa()
print(contor)nonlocal caută doar în funcțiile care o conțin. Pentru variabilele de la nivelul fișierului există global.
2Funcția exterioară nu creează variabila
def creeaza_contor():
def apasa():
nonlocal total
total += 1
return total
return apasadef creeaza_contor():
total = 0
def apasa():
nonlocal total
total += 1
return total
return apasa
apasa = creeaza_contor()
apasa()
print(apasa())Variabila trebuie să existe în funcția exterioară (aici total = 0), ca să aibă de ce se lega.
Repară eroarea, direct în pagină
Funcția creeaza_contor ar trebui să întoarcă o funcție care numără apăsările unui buton, dar Python dă SyntaxError: no binding for nonlocal 'apasari' found. Repară codul ca, după trei apeluri, programul să afișeze 3.
def creeaza_contor():
def apasa():
nonlocal apasari
apasari += 1
return apasari
return apasa
buton = creeaza_contor()
buton()
buton()
print(buton())3
Indiciu
nonlocal are nevoie de o variabilă creată în funcția exterioară.
Reparația
def creeaza_contor():
apasari = 0
def apasa():
nonlocal apasari
apasari += 1
return apasari
return apasa
buton = creeaza_contor()
buton()
buton()
print(buton())De ce merge
nonlocal apasari cere ca apasari să fie o variabilă a funcției exterioare creeaza_contor. Fără apasari = 0 acolo, nu exista nimic de legat. După reparație, fiecare apel al lui buton modifică aceeași variabilă din closure, iar al treilea apel întoarce 3.
Alte forme ale mesajului
SyntaxError: no binding for nonlocal 'total' foundSyntaxError: nonlocal declaration not allowed at module level
Cum o eviți pe viitor
- Folosește
nonlocaldoar în funcții imbricate (closure-uri), după ce funcția exterioară a creat variabila. - Pentru stare simplă, evită atât
global, cât șinonlocal: primește valoarea ca parametru și returnează noua valoare. - Pentru stare care durează, o clasă mică e adesea mai clară decât un closure.
Întrebări frecvente
Care e diferența dintre global și nonlocal?
global leagă de variabila de la nivelul fișierului (modulului). nonlocal leagă de variabila celei mai apropiate funcții exterioare. La nivelul fișierului nu există „nonlocal”.
Am nevoie de nonlocal ca să citesc variabila?
Nu. Doar ca să o modifici (+=, =). Pentru citire, funcția interioară vede singură variabilele funcției exterioare.
Erori înrudite
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`. SyntaxError: name 'contor' is used prior to global declaration Într-o funcție ai folosit variabila înainte de linia `global contor`. Declarația `global` trebuie să fie prima mențiune a numelui în funcție: mut-o la începutul funcției, sau, mai bine, renunță la `global` și întoarce valoarea cu `return`. 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. Î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.
