CKTIS / Python
`object.__next__`: pobieranie kolejnego elementu z iteratora
Metoda `__next__` zwraca kolejny element i przesuwa pozycję iteratora. Po wyczerpaniu iteratora każde kolejne wywołanie zgłasza `StopIteration`.
Wersja: Python 3.12
Składnia
class MyIterator:
def __iter__(self): ...
def __next__(self): ...
# Built-in calls
iter(iterable)
next(iterator)
next(iterator, default)W Pythonie 3.12 zapis object.__next__ oznacza tutaj metodę specjalną obiektu będącego iteratorem, a nie metodę wbudowanej klasy object. Zdefiniuj __next__(self) w klasie iteratora. Przy udanym wywołaniu metoda zwraca jeden element i aktualizuje stan tak, by następne wywołanie zaczęło od kolejnej pozycji.
Dla obiektu iterowalnego, który pozwala wielokrotnie przejść po elementach od początku, __iter__ może za każdym razem tworzyć nowy iterator. W przykładzie Letters.__iter__ właśnie tak działa, a LetterIterator.__init__ ustawia dla każdego iteratora własną pozycję początkową. Natomiast LetterIterator.__iter__ zwraca self, więc iter(a) nie tworzy kopii ani nie resetuje pozycji.
Gdy nie ma już elementów, __next__ musi zgłosić StopIteration, również przy każdym późniejszym wywołaniu. Nie zwracaj w tym celu None: to poprawna wartość elementu. Funkcja next(a) wywołuje __next__ i przekazuje wyjątek dalej, a next(a, default) zwraca przy wyczerpaniu podaną wartość domyślną. Pętla for pobiera iterator i kończy się po otrzymaniu StopIteration.
Przykłady
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')Wynik
A True B A END StopIteration
Po pierwszym `A` wyrażenie `iter(a) is a` daje `True`, a `a` zwraca następnie `B`. Niezależny `b` zaczyna od `A`. Dla wyczerpanego `a` wywołanie z wartością domyślną daje `END`, a wywołanie bez niej zgłasza `StopIteration`.
Powiązane lekcje
- Python · Lekcja 8 · Zaawansowany · Wersja: 5