Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje