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

CKTIS / Python

`object.__next__` : avancer dans un itérateur

`__next__` renvoie un élément et fait avancer l’itérateur. Une fois celui-ci épuisé, la méthode lève `StopIteration` à chaque nouvel appel.

Version : Python 3.12

Syntaxe

class MyIterator:
    def __iter__(self): ...
    def __next__(self): ...

# Built-in calls
iter(iterable)
next(iterator)
next(iterator, default)

En Python 3.12, object.__next__ désigne ici une méthode spéciale d’un objet itérateur, et non une méthode de la classe native object. Définissez __next__(self) dans la classe de l’itérateur. En cas de succès, la méthode renvoie un élément et met à jour l’état pour que l’appel suivant reprenne à la position suivante.

Un objet itérable conçu pour être parcouru plusieurs fois depuis le début peut créer un nouvel itérateur à chaque appel de __iter__. Dans l’exemple, Letters.__iter__ procède ainsi, et LetterIterator.__init__ initialise la position propre à chaque itérateur. En revanche, LetterIterator.__iter__ renvoie self : iter(a) ne crée donc pas de copie et ne réinitialise pas la position.

Lorsqu’il ne reste aucun élément, __next__ doit lever StopIteration, y compris à tous les appels suivants. Ne renvoyez pas None pour signaler la fin : None peut être un élément valide. La fonction native next(a) appelle __next__ et propage l’exception, tandis que next(a, default) renvoie la valeur par défaut fournie si l’itérateur est épuisé. Une boucle for obtient un itérateur et se termine sur StopIteration.

Exemples

class Letters:
    def __iter__(self):
        return LetterIterator()


class LetterIterator:
    def __init__(self):
        self.position = 0

    def __iter__(self):
        return self

    def __next__(self):
        letters = ('A', 'B')
        if self.position >= len(letters):
            raise StopIteration
        letter = letters[self.position]
        self.position += 1
        return letter


letters = Letters()
a = iter(letters)
b = iter(letters)
print(next(a))
print(iter(a) is a)
print(next(a))
print(next(b))
print(next(a, 'END'))
try:
    next(a)
except StopIteration:
    print('StopIteration')

Résultat

A
True
B
A
END
StopIteration

Après le premier `A`, `iter(a) is a` donne `True`, puis `a` renvoie `B`. L’itérateur indépendant `b` commence par `A`. Une fois `a` épuisé, l’appel avec une valeur par défaut donne `END`, et celui sans valeur par défaut lève `StopIteration`.

Leçons associées

  • Python · Leçon 8 · Avancé · Version : 5

Sources