Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje