CKTIS / Python
StopIteration — esaurimento dell’iteratore
StopIteration segnala che un iteratore si è esaurito durante next(). Il suo attributo value può contenere il valore restituito da un generatore. Terminare un generatore con return è diverso dal lasciare che un StopIteration sollevato esplicitamente fuoriesca dal suo codice.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration segnala che un iteratore non ha altri elementi. next(iterator) chiama iterator.__next__(); quando l’iteratore è esaurito, solleva l’eccezione, a meno che non sia stato fornito un valore predefinito.
next(iterator, default) restituisce l’elemento successivo se è disponibile. Solo quando l’iteratore è esaurito restituisce default invece di sollevare StopIteration. Scegli un valore predefinito distinguibile dagli elementi validi. Quando gestisci l’eccezione manualmente, limita il blocco try al recupero di un elemento.
StopIteration(value) memorizza il suo argomento in value, che per impostazione predefinita è None. Terminare un generatore con return result rende result disponibile come StopIteration.value, non come un altro elemento prodotto da yield.
All’interno di un generatore, usa return, non raise StopIteration. Se un StopIteration sollevato direttamente o indirettamente fuoriesce dal suo codice, Python lo converte in RuntimeError, conservando l’eccezione originale come causa. L’iterazione asincrona termina con il distinto StopAsyncIteration.
Esempi
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"))Risultato
7 StopIteration 99 END
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.