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