Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

IndexError — indice di sequenza fuori intervallo

IndexError è un’eccezione integrata che viene generata quando si tenta di accedere a un elemento di una sequenza usando un indice fuori intervallo. Scopri i limiti degli indici validi, la differenza tra indicizzazione e slicing e come intercettare questa eccezione.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

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

IndexError significa che l’indice di un elemento di una sequenza è fuori intervallo. Riguarda, per esempio, liste, tuple e stringhe. È una sottoclasse di LookupError; una chiave di dizionario mancante causa invece KeyError.

Per una sequenza integrata s di lunghezza n, gli indici interi validi soddisfano -n <= i < n. L’indice 0 seleziona il primo elemento e -1 l’ultimo. Una sequenza vuota non ha alcun indice valido per un elemento. Un errore comune è usare s[len(s)]: l’ultimo elemento di una sequenza non vuota ha indice len(s) - 1.

Indicizzazione e slicing sono operazioni diverse. Per la lista dell’esempio, items[3] genera IndexError, mentre items[3:] restituisce una lista vuota: i limiti dello slicing vengono contenuti nell’intervallo della sequenza. Un tipo di indice non supportato, per esempio una stringa usata per indicizzare una lista, causa TypeError, non IndexError.

Se l’assenza di un elemento è una situazione prevista, intercetta IndexError in un blocco try ristretto all’accesso interessato. Se indica un errore di programmazione, correggi il calcolo dell’indice invece di nasconderlo. Se ti servono soltanto i valori degli elementi, considera di iterare direttamente sulla sequenza.

Esempi

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

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

Risultato

30
[]
IndexError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti