База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

KeyError — липсващ ключ в съпоставяне

KeyError означава, че търсеният ключ не е намерен в съпоставяне, например dict. Научете разликата между достъпа с квадратни скоби и get() и обработвайте липсващи ключове, без да прикривате несвързани грешки.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

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

KeyError е вградено изключение, наследено от LookupError. То сигнализира, че в съпоставянето липсва търсеният ключ. При обикновен dict изразът mapping[key] предизвиква това изключение, когато ключът не съществува. Не го бъркайте с IndexError, което се отнася до индекс извън обхвата на последователност.

Ако липсващ ключ е очакван случай, използвайте try / except KeyError или mapping.get(key, default). При dict get() връща стойността по подразбиране само когато ключът липсва; ако такава стойност не е зададена изрично, в този случай се връща None. Съществуващ ключ със стойност None не е липсващ и не задейства използването на стойността по подразбиране. Изразът key in mapping проверява дали ключът присъства.

Ограничете блока try до операцията, при която искате да обработите липсващ ключ, за да не прихванете случайно KeyError от друго извикване. Ако ключът е задължителен, коригирайте входните данни или оставете изключението да се разпространи, вместо безусловно да го игнорирате.

Примерът сравнява липсващия ключ "language" със съществуващия ключ "nickname", чиято стойност е None. Забележка: подклас на dict може да дефинира __missing__() и да промени начина, по който mapping[key] обработва липсващ ключ; get() не извиква този механизъм.

Примери

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"))

Резултат

Missing key: language
en
None

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници