Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

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

Viri