CKTIS / Python
IndexError — índice de secuencia fuera de rango
IndexError es una excepción integrada que se produce al intentar acceder a un elemento de una secuencia con un índice fuera de rango. Aprende cuáles son los límites de los índices válidos, qué diferencia hay entre indexar y usar un segmento, y cómo capturar esta excepción.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
sequence[index]
try:
sequence[index]
except IndexError:
...IndexError significa que el índice de un elemento de una secuencia está fuera de rango. Esto se aplica, por ejemplo, a listas, tuplas y cadenas. Es una subclase de LookupError; en cambio, una clave de diccionario que no existe provoca KeyError.
Para una secuencia integrada s de longitud n, los índices enteros válidos cumplen -n <= i < n. El índice 0 selecciona el primer elemento y -1 el último. Una secuencia vacía no tiene ningún índice de elemento válido. Un error habitual es usar s[len(s)]: el último elemento de una secuencia no vacía tiene el índice len(s) - 1.
Indexar y usar segmentos son operaciones distintas. En la lista del ejemplo, items[3] provoca IndexError, pero items[3:] devuelve una lista vacía: los límites de un segmento se ajustan al rango de la secuencia. Un tipo de índice no admitido, como una cadena usada para indexar una lista, provoca TypeError, no IndexError.
Si es normal que falte un elemento, captura IndexError en un bloque try limitado al acceso correspondiente. Si indica un error de programación, corrige el cálculo del índice en lugar de ocultarlo. Si solo necesitas los valores de los elementos, considera iterar directamente sobre la secuencia.
Ejemplos
items = [10, 20, 30]
print(items[-1])
print(items[3:])
try:
print(items[3])
except IndexError:
print("IndexError")Resultado
30 [] IndexError
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.