CKTIS / Python
KeyError — chybějící klíč v mapování
KeyError znamená, že požadovaný klíč nebyl v mapování, například v objektu dict, nalezen. Poznejte rozdíl mezi přístupem pomocí hranatých závorek a metodou get() a ošetřujte chybějící klíče, aniž byste skrývali jiné chyby.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
try:
value = mapping[key]
except KeyError:
...KeyError je vestavěná výjimka odvozená od LookupError. Označuje, že v mapování chybí požadovaný klíč. U běžného dict vyvolá mapping[key] tuto výjimku, pokud klíč neexistuje. Nezaměňujte ji s IndexError, která se týká indexu mimo rozsah sekvence.
Pokud lze chybějící klíč očekávat, použijte try / except KeyError nebo mapping.get(key, default). U dict vrací get() výchozí hodnotu pouze tehdy, když klíč chybí; pokud výchozí hodnotu výslovně neuvedete, vrátí v takovém případě None. Existující klíč s hodnotou None není chybějící klíč a nezpůsobí použití výchozí hodnoty. Výraz key in mapping ověřuje, zda mapování klíč obsahuje.
Blok try omezte na operaci, při které chcete chybějící klíč ošetřit, abyste omylem nezachytili KeyError z jiného volání. Pokud je klíč povinný, opravte vstupní data nebo nechte výjimku pokračovat dál, místo abyste ji bezpodmínečně ignorovali.
Příklad porovnává chybějící klíč "language" s existujícím klíčem "nickname", jehož hodnota je None. Upozornění: podtřída dict může definovat __missing__() a změnit způsob, jakým mapping[key] zpracuje chybějící klíč; get() tento mechanismus nevolá.
Příklady
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"))Výsledek
Missing key: language en None
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.