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.