CKTIS / Python
KeyError — manjkajoči ključ v preslikavi
KeyError pomeni, da zahtevanega ključa ni bilo mogoče najti v preslikavi, na primer v objektu dict. Spoznajte razliko med dostopom z oglatimi oklepaji in metodo get() ter obravnavajte manjkajoče ključe, ne da bi skrili druge napake.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
try:
value = mapping[key]
except KeyError:
...KeyError je vgrajena izjema, ki izhaja iz LookupError. Sporoča, da v preslikavi manjka zahtevani ključ. Pri običajnem dict izraz mapping[key] sproži to izjemo, če ključ ne obstaja. Ne zamenjujte je z IndexError, ki se nanaša na indeks zunaj obsega zaporedja.
Če je mogoče pričakovati, da ključ manjka, uporabite try / except KeyError ali mapping.get(key, default). Pri dict metoda get() vrne privzeto vrednost samo, če ključa ni; če privzete vrednosti izrecno ne navedete, v tem primeru vrne None. Obstoječi ključ z vrednostjo None ni manjkajoči ključ in ne povzroči uporabe privzete vrednosti. Izraz key in mapping preveri, ali je ključ prisoten.
Blok try omejite na operacijo, pri kateri želite obravnavati manjkajoči ključ, da po pomoti ne prestrežete izjeme KeyError iz drugega klica. Če je ključ obvezen, popravite vhodne podatke ali pustite, da se izjema širi naprej, namesto da jo brezpogojno prezrete.
Primer primerja manjkajoči ključ "language" z obstoječim ključem "nickname", katerega vrednost je None. Opozorilo: podrazred dict lahko določi __missing__() in spremeni, kako mapping[key] obravnava manjkajoči ključ; get() tega mehanizma ne pokliče.
Primeri
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"))Rezultat
Missing key: language en None
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.