CKTIS / Python
IndexError — Sequenzindex außerhalb des gültigen Bereichs
IndexError ist eine eingebaute Ausnahme, die ausgelöst wird, wenn beim Zugriff auf ein Sequenzelement ein Index außerhalb des gültigen Bereichs verwendet wird. Erfahre mehr über gültige Indexgrenzen, den Unterschied zwischen Indizierung und Slicing sowie darüber, wie du diese Ausnahme abfängst.
Version: Python 3.14; repository image, production runtime not attested
Syntax
sequence[index]
try:
sequence[index]
except IndexError:
...IndexError bedeutet, dass der Index eines Sequenzelements außerhalb des gültigen Bereichs liegt. Das gilt zum Beispiel für Listen, Tupel und Zeichenketten. IndexError ist eine Unterklasse von LookupError; ein fehlender Wörterbuchschlüssel führt stattdessen zu KeyError.
Für eine eingebaute Sequenz s der Länge n gilt für gültige ganzzahlige Indizes -n <= i < n. Der Index 0 wählt das erste Element aus, -1 das letzte. Eine leere Sequenz hat keinen gültigen Elementindex. Ein häufiger Fehler ist s[len(s)]: Das letzte Element einer nicht leeren Sequenz hat den Index len(s) - 1.
Indizierung und Slicing sind unterschiedliche Operationen. Bei der Beispielliste löst items[3] einen IndexError aus, aber items[3:] gibt eine leere Liste zurück: Die Grenzen eines Slices werden auf den Bereich der Sequenz begrenzt. Ein nicht unterstützter Indextyp, etwa eine Zeichenkette als Listenindex, führt zu TypeError, nicht zu IndexError.
Wenn ein fehlendes Element zu erwarten ist, fange IndexError in einem eng gefassten try-Block direkt um den betreffenden Zugriff ab. Wenn die Ausnahme auf einen Programmierfehler hinweist, korrigiere die Indexberechnung, statt den Fehler zu verbergen. Wenn du nur die Elementwerte benötigst, kannst du direkt über die Sequenz iterieren.
Beispiele
items = [10, 20, 30]
print(items[-1])
print(items[3:])
try:
print(items[3])
except IndexError:
print("IndexError")Ergebnis
30 [] IndexError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.