CKTIS / Python
StopIteration — vyčerpání iterátoru
StopIteration signalizuje vyčerpání iterátoru během volání next(). Jeho atribut value může obsahovat návratovou hodnotu generátoru. Ukončení generátoru pomocí return se liší od situace, kdy z jeho kódu unikne explicitně vyvolaná výjimka StopIteration.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration signalizuje, že iterátor už nemá žádné další položky. next(iterator) volá iterator.__next__(); při vyčerpání iterátoru vyvolá výjimku, pokud nebyla zadána výchozí hodnota.
next(iterator, default) vrátí další položku, pokud je k dispozici. Teprve po vyčerpání iterátoru vrátí default místo vyvolání StopIteration. Zvolte výchozí hodnotu, kterou lze odlišit od platných položek. Při ručním zachytávání výjimky omezte blok try pouze na získání položky.
StopIteration(value) uloží svůj argument do value, jehož výchozí hodnota je None. Ukončení generátoru pomocí return result zpřístupní result jako StopIteration.value, nikoli jako další položku z yield.
Uvnitř generátoru používejte return, ne raise StopIteration. Pokud z jeho kódu unikne přímo či nepřímo vyvolaná výjimka StopIteration, Python ji převede na RuntimeError a původní výjimku zachová jako příčinu. Asynchronní iterace končí odlišnou výjimkou StopAsyncIteration.
Příklady
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"))Výsledek
7 StopIteration 99 END
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.