KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

IndexError — sequentie-index buiten bereik

IndexError is een ingebouwde uitzondering die wordt veroorzaakt wanneer je een element uit een sequentie probeert op te vragen met een index buiten het bereik. Leer wat de grenzen van geldige indices zijn, wat het verschil is tussen indexeren en slicen en hoe je deze uitzondering opvangt.

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

Syntax

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

IndexError betekent dat de index van een sequentie-element buiten het bereik valt. Dit geldt bijvoorbeeld voor lijsten, tuples en strings. Het is een subklasse van LookupError; een ontbrekende woordenboeksleutel veroorzaakt in plaats daarvan KeyError.

Voor een ingebouwde sequentie s met lengte n voldoen geldige gehele indices aan -n <= i < n. Index 0 selecteert het eerste element en -1 het laatste. Een lege sequentie heeft geen geldige elementindex. Een veelgemaakte fout is s[len(s)] gebruiken: het laatste element van een niet-lege sequentie heeft index len(s) - 1.

Indexeren en slicen zijn verschillende bewerkingen. Voor de voorbeeldlijst veroorzaakt items[3] een IndexError, maar geeft items[3:] een lege lijst terug: de grenzen van een slice worden beperkt tot het bereik van de sequentie. Een niet-ondersteund indextype, zoals een string als index van een lijst, veroorzaakt TypeError, geen IndexError.

Als het ontbreken van een element te verwachten is, vang je IndexError op en beperk je het try-blok tot het opvragen van dat element. Als de uitzondering op een programmeerfout wijst, verbeter dan de indexberekening in plaats van de fout te verbergen. Als je alleen de elementwaarden nodig hebt, kun je overwegen rechtstreeks over de sequentie te itereren.

Voorbeelden

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

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

Resultaat

30
[]
IndexError

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen