Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

`object.__next__`: avanzar un iterador

`__next__` devuelve un elemento y hace avanzar el iterador. Una vez agotado, el método lanza `StopIteration` en todas las llamadas posteriores.

Versión: Python 3.12

Sintaxis

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

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

En Python 3.12, object.__next__ designa aquí un método especial de un objeto iterador, no un método de la clase integrada object. Define __next__(self) en la clase del iterador. Una llamada exitosa devuelve un elemento y actualiza el estado para que la siguiente llamada continúe en la posición siguiente.

Un iterable diseñado para recorrerse varias veces desde el principio puede crear un iterador nuevo en cada llamada a __iter__. En el ejemplo, Letters.__iter__ hace eso y LetterIterator.__init__ asigna a cada iterador su propia posición inicial. En cambio, LetterIterator.__iter__ devuelve self, así que iter(a) no crea una copia ni reinicia la posición.

Cuando no quedan elementos, __next__ debe lanzar StopIteration, también en todas las llamadas posteriores. No devuelvas None para indicar el fin: None es un elemento válido. La función integrada next(a) llama a __next__ y propaga la excepción, mientras que next(a, default) devuelve el valor predeterminado proporcionado si el iterador está agotado. Un bucle for obtiene un iterador y termina al recibir StopIteration.

Ejemplos

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

Tras el primer `A`, `iter(a) is a` da `True`, y `a` devuelve después `B`. El iterador independiente `b` empieza por `A`. Una vez agotado `a`, la llamada con valor predeterminado da `END` y la llamada sin él lanza `StopIteration`.

Lecciones relacionadas

  • Python · Lección 8 · Avanzado · Versión: 5

Fuentes