CKTIS / Python
KeyError — chýbajúci kľúč v mapovaní
KeyError znamená, že požadovaný kľúč sa v mapovaní, napríklad v objekte dict, nenašiel. Spoznajte rozdiel medzi prístupom pomocou hranatých zátvoriek a metódou get() a ošetrujte chýbajúce kľúče bez skrývania iných chýb.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
try:
value = mapping[key]
except KeyError:
...KeyError je vstavaná výnimka odvodená od LookupError. Signalizuje, že v mapovaní chýba požadovaný kľúč. Pri bežnom dict vyvolá mapping[key] túto výnimku, keď kľúč neexistuje. Nezamieňajte si ju s IndexError, ktorá sa týka indexu mimo rozsahu sekvencie.
Ak sa dá očakávať, že kľúč bude chýbať, použite try / except KeyError alebo mapping.get(key, default). Pri dict vráti get() predvolenú hodnotu iba vtedy, keď kľúč chýba; ak predvolenú hodnotu výslovne neuvediete, v takom prípade vráti None. Existujúci kľúč s hodnotou None nechýba a nespôsobí použitie predvolenej hodnoty. Výraz key in mapping overí, či mapovanie obsahuje daný kľúč.
Blok try obmedzte na operáciu, pri ktorej chcete ošetriť chýbajúci kľúč, aby ste omylom nezachytili KeyError z iného volania. Ak je kľúč povinný, opravte vstupné údaje alebo nechajte výnimku šíriť sa ďalej, namiesto toho, aby ste ju bezpodmienečne ignorovali.
Príklad porovnáva chýbajúci kľúč "language" s existujúcim kľúčom "nickname", ktorého hodnota je None. Upozornenie: podtrieda dict môže definovať __missing__() a zmeniť spôsob, akým mapping[key] pracuje s chýbajúcim kľúčom; get() tento mechanizmus nevolá.
Prí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ýsledok
Missing key: language en None
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.