Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

KeyError — brak klucza w mapowaniu

KeyError oznacza, że żądanego klucza nie znaleziono w mapowaniu, na przykład słowniku dict. Poznaj różnicę między odczytem przez nawiasy kwadratowe a metodą get() i obsługuj brak klucza bez ukrywania innych błędów.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

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

KeyError jest wbudowanym wyjątkiem dziedziczącym po LookupError. Sygnalizuje brak żądanego klucza w mapowaniu. Dla zwykłego słownika dict wyrażenie mapping[key] zgłasza ten wyjątek, gdy klucz nie istnieje. Nie należy mylić go z IndexError, który dotyczy indeksu poza zakresem sekwencji.

Jeśli brak klucza jest przewidywaną sytuacją, użyj try / except KeyError albo mapping.get(key, default). W słowniku dict metoda get() zwraca wartość domyślną tylko wtedy, gdy klucza brakuje; bez podanej wartości domyślnej zwraca wtedy None. Istniejący klucz z wartością None nie oznacza braku klucza i nie powoduje użycia wartości domyślnej. Wyrażenie key in mapping sprawdza obecność klucza.

Ogranicz blok try do operacji, dla której chcesz obsłużyć brak klucza, aby nie przechwycić przypadkiem KeyError z innego wywołania. Jeśli klucz jest wymagany, napraw dane wejściowe lub pozwól wyjątkowi się propagować zamiast bezwarunkowo go ignorować.

Przykład pokazuje brak "language" oraz istniejący "nickname" z wartością None. Uwaga: podklasa dict może zdefiniować __missing__(), zmieniając zachowanie mapping[key] dla brakującego klucza; metoda get() nie wywołuje tego mechanizmu.

Przykłady

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

Wynik

Missing key: language
en
None

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła