CKTIS / Python
KeyError — chave em falta num mapping
KeyError significa que uma chave pedida não foi encontrada num mapping, como um dict. Aprende a diferença entre o acesso com parênteses retos e get(), e a tratar chaves em falta sem ocultar erros não relacionados.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
try:
value = mapping[key]
except KeyError:
...KeyError é uma exceção integrada que deriva de LookupError. Indica que falta uma chave pedida num mapping. Num dict normal, mapping[key] lança esta exceção quando a chave não existe. Não a confundas com IndexError, que diz respeito a um índice fora dos limites de uma sequência.
Se for previsível que falte uma chave, usa try / except KeyError ou mapping.get(key, default). Num dict, get() devolve o valor predefinido apenas quando a chave está ausente; se não for indicado explicitamente um valor predefinido, devolve None nesse caso. Uma chave existente cujo valor seja None não está em falta e não faz com que seja usado o valor predefinido. A expressão key in mapping verifica se a chave está presente.
Limita o bloco try à operação em que pretendes tratar a falta de uma chave, para não capturares acidentalmente um KeyError de outra chamada. Se a chave for obrigatória, corrige os dados de entrada ou deixa a exceção propagar-se, em vez de a ignorares incondicionalmente.
O exemplo compara a chave "language", que está em falta, com a chave existente "nickname", cujo valor é None. Nota: uma subclasse de dict pode definir __missing__() para alterar a forma como mapping[key] trata uma chave ausente; get() não invoca esse mecanismo.
Exemplos
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"))Resultado
Missing key: language en None
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.