Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje