CKTIS / Python
StopIteration — koniec iteratora
StopIteration sygnalizuje wyczerpanie iteratora podczas next(). Atrybut value może przenosić wynik zwrócony przez generator. Nie należy mylić zakończenia generatora przez return z wypuszczeniem z niego jawnie zgłoszonego StopIteration.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration sygnalizuje, że iterator nie ma kolejnych elementów. next(iterator) wywołuje iterator.__next__(); po wyczerpaniu iteratora zgłasza wyjątek, chyba że podano wartość domyślną.
next(iterator, default) zwraca kolejny element, jeśli jest dostępny. Dopiero gdy iterator jest wyczerpany, zwraca default zamiast zgłaszać StopIteration. Wybierz wartość domyślną odróżnialną od prawidłowych elementów. Przy ręcznej obsłudze wyjątku ogranicz blok try do pobrania elementu.
StopIteration(value) zapisuje argument w value; domyślnie jest to None. Zakończenie generatora przez return result udostępnia result jako StopIteration.value, a nie jako kolejny element z yield.
W generatorze używaj return, nie raise StopIteration. Jeśli zgłoszony bezpośrednio lub pośrednio StopIteration wydostanie się z jego kodu, Python przekształci go w RuntimeError, zachowując pierwotny wyjątek jako przyczynę. Iterację asynchroniczną kończy odrębny StopAsyncIteration.
Przykłady
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"))Wynik
7 StopIteration 99 END
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.