KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

KeyError — ontbrekende sleutel in een mapping

KeyError betekent dat een opgevraagde sleutel niet is gevonden in een mapping, zoals een dict. Leer het verschil tussen toegang met vierkante haken en get(), en behandel ontbrekende sleutels zonder andere fouten te verbergen.

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

Syntax

try:
    value = mapping[key]
except KeyError:
    ...

KeyError is een ingebouwde uitzondering die is afgeleid van LookupError. De uitzondering geeft aan dat een opgevraagde sleutel in een mapping ontbreekt. Bij een gewone dict veroorzaakt mapping[key] deze uitzondering als de sleutel niet bestaat. Verwar dit niet met IndexError, dat gaat over een index buiten het bereik van een sequentie.

Als het ontbreken van een sleutel te verwachten is, gebruik je try / except KeyError of mapping.get(key, default). Bij een dict geeft get() de standaardwaarde alleen terug als de sleutel ontbreekt; zonder expliciet opgegeven standaardwaarde geeft de methode in dat geval None terug. Een bestaande sleutel met de waarde None ontbreekt niet en zorgt er niet voor dat de standaardwaarde wordt gebruikt. Met de expressie key in mapping controleer je of de sleutel aanwezig is.

Beperk het try-blok tot de bewerking waarvan je de ontbrekende sleutel wilt afhandelen. Zo vang je niet per ongeluk een KeyError van een andere aanroep op. Als de sleutel verplicht is, corrigeer je de invoer of laat je de uitzondering zich verder verspreiden, in plaats van deze zonder meer te negeren.

Het voorbeeld vergelijkt de ontbrekende sleutel "language" met de bestaande sleutel "nickname", die de waarde None heeft. Let op: een dict-subklasse kan __missing__() definiëren en zo veranderen hoe mapping[key] met een ontbrekende sleutel omgaat; get() roept dit mechanisme niet aan.

Voorbeelden

settings = {"theme": "dark", "nickname": None}

try:
    print(settings["language"])
except KeyError:
    print("Missing key: language")

print(settings.get("language", "en"))
print(settings.get("nickname", "guest"))

Resultaat

Missing key: language
en
None

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