¿Qué significa StopIteration?

StopIteration es lanzado por el método __next__() de un iterador para indicar que no hay más elementos que producir. Es la señal de terminación normal para los iteradores y es capturada automáticamente por los bucles for, pero se propagará como error si llamas a next() manualmente sin un valor por defecto.

Por qué ocurre

• •Llamar a next() sobre un iterador que ya fue completamente consumido.
• •Usar next() dentro de una función generadora, lo que hace que el propio generador se detenga.
• •Iterar manualmente con next() en lugar de usar un bucle for, sin proporcionar un valor por defecto.
• •Consumir un generador o iterador en un lugar e intentar iterarlo de nuevo (los iteradores no se pueden rebobinar).

Ejemplos

numbers = iter([1, 2, 3])

print(next(numbers))  # 1
print(next(numbers))  # 2
print(next(numbers))  # 3
print(next(numbers))  # iterator is exhausted

1
2
3
Traceback (most recent call last):
  File "app.py", line 6, in <module>
    print(next(numbers))
StopIteration

numbers = iter([1, 2, 3])

# Use a default value to avoid the exception
value = next(numbers, None)
while value is not None:
    print(value)
    value = next(numbers, None)

# Or simply iterate with a for loop:
for n in [1, 2, 3]:
    print(n)

Errores relacionados

• ValueError
• IndexError