WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

StopIteration — Erschöpfung eines Iterators

StopIteration signalisiert, dass ein Iterator bei next() erschöpft ist. Das Attribut value kann den Rückgabewert eines Generators enthalten. Das Beenden eines Generators mit return ist nicht damit gleichzusetzen, dass ein explizit ausgelöstes StopIteration aus seinem Code entkommt.

Version: Python 3.14; repository image, production runtime not attested

Syntax

StopIteration(*args)
try:
    item = next(iterator)
except StopIteration as exc:
    result = exc.value

StopIteration signalisiert, dass ein Iterator keine weiteren Elemente hat. next(iterator) ruft iterator.__next__() auf; bei Erschöpfung löst es die Ausnahme aus, sofern kein Standardwert angegeben wurde.

next(iterator, default) gibt das nächste Element zurück, wenn eines verfügbar ist. Erst wenn der Iterator erschöpft ist, gibt der Aufruf default zurück, anstatt StopIteration auszulösen. Wähle einen Standardwert, der sich von gültigen Elementen unterscheiden lässt. Wenn du die Ausnahme manuell behandelst, beschränke den try-Block auf das Abrufen eines Elements.

StopIteration(value) speichert sein Argument in value; der Standardwert ist None. Wird ein Generator mit return result beendet, ist result als StopIteration.value verfügbar und nicht als weiteres Element aus yield.

Verwende in einem Generator return und nicht raise StopIteration. Entkommt ein direkt oder indirekt ausgelöstes StopIteration aus seinem Code, wandelt Python es in RuntimeError um und behält die ursprüngliche Ausnahme als Ursache bei. Die asynchrone Iteration endet mit dem separaten StopAsyncIteration.

Beispiele

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"))

Ergebnis

7
StopIteration 99
END

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen