Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

`object.__next__`: avançar um iterador

`__next__` devolve um elemento e avança o iterador. Quando o iterador se esgota, o método lança `StopIteration` em todas as chamadas seguintes.

Versão: Python 3.12

Sintaxe

class MyIterator:
    def __iter__(self): ...
    def __next__(self): ...

# Built-in calls
iter(iterable)
next(iterator)
next(iterator, default)

Em Python 3.12, object.__next__ designa aqui um método especial de um objeto iterador, e não um método da classe incorporada object. Define __next__(self) na classe do iterador. Uma chamada bem-sucedida devolve um elemento e atualiza o estado para que a chamada seguinte retome na posição seguinte.

Um iterável concebido para ser percorrido várias vezes desde o início pode criar um novo iterador sempre que se chama __iter__. No exemplo, Letters.__iter__ faz isso e LetterIterator.__init__ dá a cada iterador a sua própria posição inicial. Em contrapartida, LetterIterator.__iter__ devolve self, pelo que iter(a) não cria uma cópia nem repõe a posição inicial.

Quando já não há elementos, __next__ tem de lançar StopIteration, também em todas as chamadas posteriores. Não devolvas None para indicar o fim: None é um elemento válido. A função incorporada next(a) chama __next__ e propaga a exceção, enquanto next(a, default) devolve o valor predefinido fornecido se o iterador estiver esgotado. Um ciclo for obtém um iterador e termina quando encontra StopIteration.

Exemplos

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')

Resultado

A
True
B
A
END
StopIteration

Depois do primeiro `A`, `iter(a) is a` resulta em `True` e `a` devolve depois `B`. O iterador independente `b` começa em `A`. Quando `a` se esgota, a chamada com um valor predefinido devolve `END` e a chamada sem esse valor lança `StopIteration`.

Lições relacionadas

  • Python · Lição 8 · Avançado · Versão: 5

Fontes