Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

`object.__next__`: far avanzare un iteratore

`__next__` restituisce un elemento e fa avanzare l’iteratore. Una volta esaurito l’iteratore, il metodo solleva `StopIteration` a ogni chiamata successiva.

Versione: Python 3.12

Sintassi

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

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

In Python 3.12, object.__next__ indica qui un metodo speciale di un oggetto iteratore, non un metodo della classe predefinita object. Definisci __next__(self) nella classe dell’iteratore. Se la chiamata riesce, il metodo restituisce un elemento e aggiorna lo stato affinché la chiamata seguente riprenda dalla posizione successiva.

Un iterabile progettato per essere percorso più volte dall’inizio può creare un nuovo iteratore a ogni chiamata a __iter__. Nell’esempio, Letters.__iter__ fa proprio questo e LetterIterator.__init__ assegna a ogni iteratore una posizione iniziale propria. LetterIterator.__iter__, invece, restituisce self: iter(a) non crea una copia né ripristina la posizione iniziale.

Quando non ci sono più elementi, __next__ deve sollevare StopIteration, anche in tutte le chiamate successive. Non restituire None per segnalare la fine: None è un elemento valido. La funzione predefinita next(a) chiama __next__ e propaga l’eccezione, mentre next(a, default) restituisce il valore predefinito fornito se l’iteratore è esaurito. Un ciclo for ottiene un iteratore e termina quando incontra StopIteration.

Esempi

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')

Risultato

A
True
B
A
END
StopIteration

Dopo il primo `A`, `iter(a) is a` vale `True` e `a` restituisce poi `B`. L’iteratore indipendente `b` parte da `A`. Una volta esaurito `a`, la chiamata con un valore predefinito restituisce `END` e quella senza solleva `StopIteration`.

Lezioni correlate

  • Python · Lezione 8 · Avanzato · Versione: 5

Fonti