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.