Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

IndexError — índice de sequência fora do intervalo

IndexError é uma exceção integrada que é lançada quando se tenta aceder a um elemento de uma sequência usando um índice fora do intervalo. Saiba quais são os limites dos índices válidos, a diferença entre indexação e slicing e como capturar esta exceção.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

sequence[index]
try:
    sequence[index]
except IndexError:
    ...

IndexError significa que o índice de um elemento de uma sequência está fora do intervalo. Isto aplica-se, por exemplo, a listas, tuplos e cadeias de caracteres. É uma subclasse de LookupError; uma chave de dicionário inexistente provoca antes KeyError.

Numa sequência integrada s com comprimento n, os índices inteiros válidos satisfazem -n <= i < n. O índice 0 seleciona o primeiro elemento e -1 o último. Uma sequência vazia não tem qualquer índice válido para um elemento. Um erro comum é usar s[len(s)]: o último elemento de uma sequência não vazia tem o índice len(s) - 1.

A indexação e o slicing são operações diferentes. Na lista do exemplo, items[3] lança IndexError, mas items[3:] devolve uma lista vazia: os limites do slicing são ajustados ao intervalo da sequência. Um tipo de índice não suportado, como uma cadeia de caracteres usada para indexar uma lista, provoca TypeError, não IndexError.

Se a ausência de um elemento for uma situação prevista, capture IndexError num bloco try restrito ao acesso em causa. Se indicar um erro de programação, corrija o cálculo do índice em vez de o ocultar. Se precisar apenas dos valores dos elementos, considere iterar diretamente sobre a sequência.

Exemplos

items = [10, 20, 30]
print(items[-1])
print(items[3:])

try:
    print(items[3])
except IndexError:
    print("IndexError")

Resultado

30
[]
IndexError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes