Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

StopIteration — iscrpljivanje iteratora

StopIteration označava da se iterator iscrpio tijekom poziva next(). Njegov atribut value može sadržavati povratnu vrijednost generatora. Završetak generatora naredbom return razlikuje se od slučaja u kojem iz njegova koda izađe izričito podignuti StopIteration.

Verzija: 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čava da iterator više nema elemenata. next(iterator) poziva iterator.__next__(); kad se iterator iscrpi, podiže iznimku, osim ako je navedena zadana vrijednost.

next(iterator, default) vraća sljedeći element ako je dostupan. Tek kad se iterator iscrpi, poziv vraća default umjesto podizanja iznimke StopIteration. Odaberite zadanu vrijednost koja se može razlikovati od valjanih elemenata. Pri ručnom hvatanju iznimke ograničite blok try samo na dohvaćanje elementa.

StopIteration(value) pohranjuje argument u value, čija je zadana vrijednost None. Završetak generatora naredbom return result omogućuje pristup vrijednosti result kao StopIteration.value, a ne kao sljedećem elementu iz yield.

Unutar generatora koristite return, a ne raise StopIteration. Ako iz njegova koda izađe izravno ili neizravno podignuti StopIteration, Python ga pretvara u RuntimeError i zadržava izvornu iznimku kao uzrok. Asinkrona iteracija završava zasebnom iznimkom StopAsyncIteration.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori