Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła