Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources