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