CKTIS / Python
StopIteration — изчерпване на итератор
StopIteration сигнализира, че итераторът е изчерпан по време на next(). Атрибутът value може да съдържа върнатата стойност на генератор. Завършването на генератор с return е различно от допускането изрично повдигнат StopIteration да излезе от кода му.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration сигнализира, че итераторът няма повече елементи. next(iterator) извиква iterator.__next__(); когато итераторът е изчерпан, повдига изключението, освен ако не е зададена стойност по подразбиране.
next(iterator, default) връща следващия елемент, ако има такъв. Само когато итераторът е изчерпан, извикването връща default, вместо да повдигне StopIteration. Изберете стойност по подразбиране, която може да се различи от валидните елементи. Когато обработвате изключението ръчно, ограничете блока try до получаването на един елемент.
StopIteration(value) записва аргумента си в value, чиято стойност по подразбиране е None. Завършването на генератор с return result предоставя result като StopIteration.value, а не като следващ елемент от yield.
В генератор използвайте return, а не raise StopIteration. Ако директно или косвено повдигнат StopIteration излезе от кода му, Python го преобразува в RuntimeError и запазва първоначалното изключение като причина. Асинхронната итерация завършва с отделното изключение StopAsyncIteration.
Примери
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"))Резултат
7 StopIteration 99 END
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.