CKTIS / Python
StopIteration — uitgeputte iterator
StopIteration geeft aan dat een iterator tijdens next() is uitgeput. Het attribuut value kan de retourwaarde van een generator bevatten. Een generator beëindigen met return is iets anders dan een expliciet opgeworpen StopIteration uit de code laten ontsnappen.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration geeft aan dat een iterator geen items meer heeft. next(iterator) roept iterator.__next__() aan; als de iterator is uitgeput, wordt de uitzondering opgeworpen, tenzij er een standaardwaarde is opgegeven.
next(iterator, default) geeft het volgende item terug als er nog een is. Pas als de iterator is uitgeput, geeft de aanroep default terug in plaats van StopIteration op te werpen. Kies een standaardwaarde die te onderscheiden is van geldige items. Beperk bij handmatige afhandeling van de uitzondering het try-blok tot het ophalen van één item.
StopIteration(value) slaat het argument op in value, dat standaard None is. Als je een generator beëindigt met return result, is result beschikbaar als StopIteration.value en niet als een volgend item uit yield.
Gebruik in een generator return, niet raise StopIteration. Als een direct of indirect opgeworpen StopIteration uit de code ontsnapt, zet Python die om in RuntimeError en bewaart het de oorspronkelijke uitzondering als oorzaak. Asynchrone iteratie eindigt met de afzonderlijke uitzondering StopAsyncIteration.
Voorbeelden
def numbers():
yield 7
return 99
iterator = numbers()
print(next(iterator))
try:
next(iterator)
except StopIteration as exc:
print(type(exc).__name__, exc.value)
print(next(iterator, "END"))Resultaat
7 StopIteration 99 END
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.