CKTIS / Python
StopIteration — izčrpanje iteratorja
StopIteration označuje, da se je iterator med klicem next() izčrpal. Njegov atribut value lahko vsebuje vrnjeno vrednost generatorja. Zaključek generatorja z return se razlikuje od primera, ko iz njegove kode uide izrecno sprožen StopIteration.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration označuje, da iterator nima več elementov. next(iterator) pokliče iterator.__next__(); ko je iterator izčrpan, sproži izjemo, razen če je bila podana privzeta vrednost.
next(iterator, default) vrne naslednji element, če je na voljo. Šele ko je iterator izčrpan, vrne default, namesto da bi sprožil StopIteration. Izberite privzeto vrednost, ki jo je mogoče razlikovati od veljavnih elementov. Če izjemo obravnavate ročno, omejite blok try na pridobivanje enega elementa.
StopIteration(value) shrani argument v value, katerega privzeta vrednost je None. Zaključek generatorja z return result omogoči dostop do result prek StopIteration.value, ne pa kot do naslednjega elementa iz yield.
V generatorju uporabite return, ne raise StopIteration. Če iz njegove kode uide neposredno ali posredno sprožen StopIteration, ga Python pretvori v RuntimeError in ohrani prvotno izjemo kot vzrok. Asinhrona iteracija se konča z ločeno izjemo StopAsyncIteration.
Primeri
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"))Rezultat
7 StopIteration 99 END
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.