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