Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

StopIteration — vyčerpanie iterátora

StopIteration signalizuje vyčerpanie iterátora počas volania next(). Jeho atribút value môže obsahovať návratovú hodnotu generátora. Ukončenie generátora pomocou return sa líši od situácie, keď z jeho kódu unikne výslovne vyvolaná výnimka StopIteration.

Verzia: Python 3.14; repository image, production runtime not attested

Syntax

StopIteration(*args)
try:
    item = next(iterator)
except StopIteration as exc:
    result = exc.value

StopIteration signalizuje, že iterátor už nemá ďalšie položky. next(iterator) volá iterator.__next__(); pri vyčerpaní iterátora vyvolá výnimku, ak nebola zadaná predvolená hodnota.

next(iterator, default) vráti ďalšiu položku, ak je k dispozícii. Až po vyčerpaní iterátora vráti default namiesto vyvolania StopIteration. Vyberte predvolenú hodnotu, ktorú možno odlíšiť od platných položiek. Pri ručnom spracovaní výnimky obmedzte blok try iba na získanie položky.

StopIteration(value) uloží svoj argument do value, ktorého predvolená hodnota je None. Ukončenie generátora pomocou return result sprístupní result ako StopIteration.value, nie ako ďalšiu položku z yield.

Vo vnútri generátora používajte return, nie raise StopIteration. Ak z jeho kódu unikne priamo alebo nepriamo vyvolaná výnimka StopIteration, Python ju zmení na RuntimeError a pôvodnú výnimku zachová ako príčinu. Asynchrónna iterácia sa končí odlišnou výnimkou StopAsyncIteration.

Prí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ýsledok

7
StopIteration 99
END

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje