База знанияИзпитен център
BGБългарски
Избери език13

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.value

StopIteration сигнализира, че итераторът няма повече елементи. 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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници