CKTIS / Python
StopIteration — épuisement d’un itérateur
StopIteration signale l’épuisement d’un itérateur pendant next(). Son attribut value peut contenir la valeur de retour d’un générateur. Terminer un générateur avec return n’est pas la même chose que laisser une exception StopIteration explicitement levée s’échapper de son code.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
StopIteration(*args)
try:
item = next(iterator)
except StopIteration as exc:
result = exc.valueStopIteration signale qu’un itérateur n’a plus d’éléments. next(iterator) appelle iterator.__next__() ; lorsque l’itérateur est épuisé, l’appel lève l’exception, sauf si une valeur par défaut a été fournie.
next(iterator, default) renvoie l’élément suivant s’il y en a un. Ce n’est que lorsque l’itérateur est épuisé que l’appel renvoie default au lieu de lever StopIteration. Choisissez une valeur par défaut qui puisse être distinguée des éléments valides. Lorsque vous gérez l’exception manuellement, limitez le bloc try à la récupération d’un élément.
StopIteration(value) stocke son argument dans value, qui vaut None par défaut. Terminer un générateur avec return result rend result accessible via StopIteration.value, et non comme un autre élément produit par yield.
Dans un générateur, utilisez return, et non raise StopIteration. Si une exception StopIteration, levée directement ou indirectement, s’échappe de son code, Python la convertit en RuntimeError et conserve l’exception d’origine comme cause. L’itération asynchrone se termine avec l’exception distincte StopAsyncIteration.
Exemples
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"))Résultat
7 StopIteration 99 END
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.