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

CKTIS / Python

StopIteration — agotamiento del iterador

StopIteration indica que un iterador se ha agotado durante next(). Su atributo value puede contener el valor devuelto por un generador. Terminar un generador con return no es lo mismo que permitir que un StopIteration lanzado explícitamente escape de su código.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

StopIteration(*args)
try:
    item = next(iterator)
except StopIteration as exc:
    result = exc.value

StopIteration indica que un iterador no tiene más elementos. next(iterator) llama a iterator.__next__(); cuando el iterador se agota, lanza la excepción, salvo que se haya proporcionado un valor predeterminado.

next(iterator, default) devuelve el siguiente elemento si hay uno disponible. Solo cuando el iterador se ha agotado devuelve default en lugar de lanzar StopIteration. Elige un valor predeterminado que se pueda distinguir de los elementos válidos. Si gestionas la excepción manualmente, limita el bloque try a obtener un elemento.

StopIteration(value) guarda su argumento en value, cuyo valor predeterminado es None. Terminar un generador con return result hace que result esté disponible como StopIteration.value, no como otro elemento producido por yield.

Dentro de un generador, usa return, no raise StopIteration. Si un StopIteration lanzado directa o indirectamente escapa de su código, Python lo convierte en RuntimeError y conserva la excepción original como causa. La iteración asíncrona termina con el StopAsyncIteration, que es distinto.

Ejemplos

def numbers():
    yield 7
    return 99

iterator = numbers()
print(next(iterator))
try:
    next(iterator)
except StopIteration as exc:
    print(type(exc).__name__, exc.value)
print(next(iterator, "END"))

Resultado

7
StopIteration 99
END

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes