Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

IndexError — indeks poza zakresem sekwencji

IndexError to wbudowany wyjątek zgłaszany przy próbie dostępu do elementu sekwencji za pomocą indeksu poza zakresem. Poznaj poprawne indeksy, różnicę między indeksowaniem a wycinkiem oraz sposób przechwycenia tego wyjątku.

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

Składnia

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

IndexError oznacza, że indeks elementu sekwencji jest poza zakresem. Dotyczy to na przykład list, krotek i napisów. Jest podklasą LookupError; brakujący klucz słownika powoduje natomiast KeyError.

Dla wbudowanej sekwencji s o długości n poprawne indeksy całkowite spełniają -n <= i < n. Indeks 0 wskazuje pierwszy element, a -1 ostatni. Pusta sekwencja nie ma poprawnego indeksu elementu. Częsty błąd to użycie s[len(s)]: ostatni element niepustej sekwencji ma indeks len(s) - 1.

Indeksowanie i wycinanie to różne operacje. Dla listy z przykładu items[3] zgłasza IndexError, ale items[3:] zwraca pustą listę: granice wycinka są przycinane do zakresu sekwencji. Nieobsługiwany typ indeksu, na przykład napis użyty jako indeks listy, powoduje TypeError, a nie IndexError.

Jeżeli brak elementu jest przewidywaną sytuacją, przechwyć IndexError w wąskim bloku try, obejmującym odpowiedni dostęp. Jeżeli to błąd programu, popraw obliczanie indeksu zamiast go ukrywać. Gdy potrzebujesz wyłącznie wartości elementów, rozważ bezpośrednią iterację po sekwencji.

Przykłady

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

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

Wynik

30
[]
IndexError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła