...
Eroare Algoritmi și structuri de date · Recursivitate și backtracking

UnboundLocalError: cannot access local variable 'numar' where it is not associated with a value

Pe scurt

O funcție interioară (de obicei un dfs sau backtrack definit în altă funcție) modifică cu += o variabilă a funcției din afară. Python o tratează ca variabilă locală nouă, fără valoare. Declar-o cu nonlocal numar sau folosește o listă / returnează valoarea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În algoritmi apare des tiparul: o funcție principală definește un contor (numar = 0, cel_mai_bun = 0) și o funcție interioară recursivă (dfs, backtrack) care îl actualizează. Dacă în funcția interioară scrii numar += 1, Python vede o atribuire și decide că numar este o variabilă locală a funcției interioare. La citirea ei (partea din dreapta a lui +=) variabila locală încă nu are valoare, de unde mesajul „cannot access local variable 'numar' where it is not associated with a value”.

Citirea simplă (print(numar)) ar fi mers, pentru că fără atribuire Python caută numele în funcția din afară. Problema apare doar când atribui variabila.

Soluția este cuvântul cheie nonlocal numar la începutul funcției interioare, sau să eviți atribuirea: funcția recursivă returnează valoarea, iar apelantul o adună.

De ce apare: cauzele frecvente

1Contor modificat într-un dfs interior

Greșit
PYTHON
def numar_noduri(graf, start):
    numar = 0
    vazut = set()
    def dfs(nod):
        vazut.add(nod)
        numar += 1
        for v in graf[nod]:
            if v not in vazut:
                dfs(v)
    dfs(start)
    return numar
Corect
PYTHON
def numar_noduri(graf, start):
    numar = 0
    vazut = set()
    def dfs(nod):
        nonlocal numar
        vazut.add(nod)
        numar += 1
        for v in graf[nod]:
            if v not in vazut:
                dfs(v)
    dfs(start)
    return numar

nonlocal numar îi spune lui Python că numar este variabila funcției din afară, nu una nouă. vazut.add(...) nu avea nevoie de asta, pentru că modifică obiectul, nu reatribuie numele.

2Cel mai bun rezultat actualizat în backtracking

Greșit
PYTHON
def maxim(valori):
    cel_mai_bun = 0
    def merg(i, s):
        if i == len(valori):
            if s > cel_mai_bun:
                cel_mai_bun = s
            return
        merg(i + 1, s + valori[i])
        merg(i + 1, s)
    merg(0, 0)
    return cel_mai_bun
Corect
PYTHON
def maxim(valori):
    def merg(i, s):
        if i == len(valori):
            return s
        return max(merg(i + 1, s + valori[i]), merg(i + 1, s))
    return merg(0, 0)

Varianta corectă evită complet variabila comună: fiecare apel returnează cel mai bun rezultat al subproblemei. E mai ușor de testat și nu depinde de nonlocal.

Repară tu

Repară eroarea, direct în pagină

Funcția numar_noduri(graf, start) numără câte noduri poți atinge pornind din start, cu un DFS interior, dar dă UnboundLocalError. Repar-o fără să schimbi ideea, ca testele să afișeze 4 și 1.

Codul care dă eroarea
PYTHON
def numar_noduri(graf, start):
    numar = 0
    vazut = set()
    def dfs(nod):
        vazut.add(nod)
        numar += 1
        for v in graf[nod]:
            if v not in vazut:
                dfs(v)
    dfs(start)
    return numar

graf = {1: [2, 3], 2: [4], 3: [], 4: [1], 5: []}
print(numar_noduri(graf, 1))
print(numar_noduri(graf, 5))
După reparație, programul afișează
4
1
Indiciu

Funcția dfs trebuie să-i spună lui Python că numar este variabila funcției din afară.

Alte forme ale mesajului

  • UnboundLocalError: cannot access local variable 'contor' where it is not associated with a value
  • UnboundLocalError: local variable 'numar' referenced before assignment

Cum o eviți pe viitor

Când o funcție interioară trebuie să actualizeze o valoare a funcției exterioare, alege conștient una din variante: nonlocal nume (simplu, potrivit pentru contoare), un obiect mutabil (rezultat = [0], apoi rezultat[0] += 1) sau, cel mai curat, o funcție care returnează valoarea. La interviuri, varianta cu return arată că înțelegi recursivitatea; nonlocal e acceptat, dar spune de ce l-ai folosit.

Întrebări frecvente

De ce merge vazut.add(nod) fără nonlocal, dar numar += 1 nu?

vazut.add(nod) nu atribuie numele vazut, doar apelează o metodă pe obiectul deja existent. numar += 1 este o atribuire (numar = numar + 1), iar orice atribuire face numele local, dacă nu spui altfel.

Care e diferența dintre nonlocal și global?

nonlocal caută variabila în funcția care o conține pe cea curentă. global o caută la nivelul modulului. Pentru funcții interioare de tip dfs ai nevoie de nonlocal.

Erori înrudite

← Toate erorile Algoritmi și structuri de date

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Algoritmi și structuri de date de la zero, cu exerciții la fiecare lecție

Curs Algoritmi pentru interviuri: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 2 lecții sunt gratuite.