RuntimeError: generator raised StopIteration
În interiorul unui generator (o funcție cu `yield`) ai apelat `next()` pe un iterator terminat, iar `StopIteration` a ieșit din generator. Prinde-o și încheie generatorul cu `return`, sau dă lui `next` o valoare implicită: `next(it, None)`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
StopIteration e semnalul intern prin care un iterator spune „nu mai am elemente”. for, list() și alte construcții îl prind automat. În interiorul unui generator, însă, o StopIteration scăpată (de obicei dintr-un next(it) pe un iterator epuizat) ar fi oprit generatorul pe tăcute, ascunzând bug-uri. De aceea, din Python 3.7 (PEP 479), o astfel de StopIteration e transformată în RuntimeError: generator raised StopIteration.
Mesajul complet îți arată două excepții: StopIteration (cauza, la linia cu next) și RuntimeError (la nivelul generatorului). Reparația corectă e să tratezi explicit sfârșitul iteratorului: prinzi StopIteration și faci return, care încheie generatorul normal, sau folosești next(it, implicit) și verifici valoarea. Cazul tipic: grupezi elemente câte două sau citești o pereche antet-valoare dintr-un flux.
De ce apare: cauzele frecvente
1next fără protecție în generator
def perechi(elemente):
it = iter(elemente)
while True:
yield (next(it), next(it))
print(list(perechi([1, 2, 3, 4])))def perechi(elemente):
it = iter(elemente)
while True:
try:
yield (next(it), next(it))
except StopIteration:
return
print(list(perechi([1, 2, 3, 4])))return încheie generatorul normal când iteratorul se termină.
2Primul element dintr-o listă goală
def cu_antet(linii):
it = iter(linii)
antet = next(it)
for linie in it:
yield antet, linie
print(list(cu_antet([])))def cu_antet(linii):
it = iter(linii)
antet = next(it, None)
if antet is None:
return
for linie in it:
yield antet, linie
print(list(cu_antet([])))next(it, None) întoarce None în loc să ridice excepția, iar generatorul se încheie curat.
Repară eroarea, direct în pagină
Generatorul de mai jos grupează elementele unei liste câte două, dar la final dă RuntimeError: generator raised StopIteration. Tratează sfârșitul iteratorului în generator, ca programul să afișeze [(1, 2), (3, 4)].
def perechi(elemente):
it = iter(elemente)
while True:
a = next(it)
b = next(it)
yield (a, b)
print(list(perechi([1, 2, 3, 4])))[(1, 2), (3, 4)]
Indiciu
Prinde StopIteration în generator și încheie-l cu return.
Reparația
def perechi(elemente):
it = iter(elemente)
while True:
try:
a = next(it)
b = next(it)
except StopIteration:
return
yield (a, b)
print(list(perechi([1, 2, 3, 4])))De ce merge
După a doua pereche, next(it) nu mai are elemente și ridică StopIteration. Într-un generator, Python transformă această excepție scăpată în RuntimeError, ca să nu ascundă greșeli. Prinzând-o și făcând return, generatorul se încheie normal, iar list() primește cele două perechi.
Alte forme ale mesajului
StopIteration
Cum o eviți pe viitor
- În generatoare, nu lăsa
next()neprotejat: foloseștenext(it, implicit)sau prindeStopIteration. - Încheie generatoarele cu
return, nu curaise StopIteration. - Pentru grupări, există unelte gata făcute:
itertools.batched(elemente, 2)(Python 3.12+) sauzip(it, it). - Testează generatoarele și pe liste goale sau cu număr impar de elemente.
Întrebări frecvente
De ce Python nu lasă StopIteration să oprească generatorul?
Pentru că ar ascunde greșeli: un next greșit adânc în cod ar opri iterarea fără niciun semn, iar rezultatul ar fi pur și simplu incomplet. RuntimeError face problema vizibilă.
Care e diferența față de StopIteration simplu?
StopIteration simplu apare când apelezi next() în afara unui generator, pe un iterator terminat. Aici excepția a apărut în interiorul unui generator și Python a transformat-o.
Erori înrudite
TypeError: 'list' object is not an iterator Ai apelat `next()` direct pe o listă (sau pe un text, un dicționar). O listă se poate parcurge, dar nu e un iterator: nu ține minte unde a rămas. Creează întâi un iterator cu `it = iter(lista)` și apelează `next(it)`, sau folosește indexarea (`lista[0]`). IndexError: list index out of range Încerci să accesezi o poziție care nu există în listă: indicii merg de la 0 la `len(lista) - 1`. Cauze tipice: `lista[len(lista)]`, o buclă cu `range(len(lista) + 1)`, `lista[i + 1]` la ultimul element sau o listă goală. Pentru ultimul element folosește `lista[-1]`. TypeError: exceptions must derive from BaseException Ai dat lui `raise` ceva care nu e o excepție, de obicei un text: `raise "Fonduri insuficiente"`. Ridică o clasă de excepție cu mesajul ca argument, `raise ValueError("Fonduri insuficiente")`, iar excepțiile tale trebuie să moștenească din `Exception`. Î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.
