CKTIS / Python
`object.__next__`: posun iterátoru na další prvek
`__next__` vrátí jeden prvek a posune iterátor dál. Po vyčerpání iterátoru metoda při každém dalším volání vyvolá výjimku `StopIteration`.
Verze: Python 3.12
Syntaxe
class MyIterator:
def __iter__(self): ...
def __next__(self): ...
# Built-in calls
iter(iterable)
next(iterator)
next(iterator, default)V Pythonu 3.12 označuje object.__next__ v tomto kontextu speciální metodu objektu iterátoru, nikoli metodu vestavěné třídy object. Metodu __next__(self) definuj ve třídě iterátoru. Při úspěšném volání vrátí jeden prvek a aktualizuje stav iterátoru, aby další volání pokračovalo na následující pozici.
Iterovatelný objekt určený k opakovanému průchodu od začátku může při každém volání __iter__ vytvořit nový iterátor. V příkladu to dělá Letters.__iter__ a LetterIterator.__init__ nastaví každému iterátoru vlastní počáteční pozici. Naproti tomu LetterIterator.__iter__ vrací self, takže iter(a) nevytvoří kopii ani nevrátí iterátor na začátek.
Jakmile žádné prvky nezbývají, __next__ musí vyvolat StopIteration, a to i při všech dalších voláních. Konec neoznačuj návratem None: None je platná hodnota prvku. Vestavěná funkce next(a) volá __next__ a předává výjimku dál, zatímco next(a, default) při vyčerpání vrátí zadanou výchozí hodnotu. Cyklus for získá iterátor a skončí při StopIteration.
Příklady
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')Výsledek
A True B A END StopIteration
Po prvním `A` je výsledek `iter(a) is a` roven `True` a z `a` pak dostaneš `B`. Nezávislý iterátor `b` začíná hodnotou `A`. Po vyčerpání `a` vrátí volání s výchozí hodnotou `END` a volání bez ní vyvolá `StopIteration`.
Související lekce
- Python · Lekce 8 · Pokročilá · Verze: 5