Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

TypeError — uma operação sobre um objeto de tipo inadequado

TypeError significa que uma operação ou função recebeu um objeto de tipo inadequado. Saiba em que difere de ValueError e como o tratar sem ocultar o problema subjacente.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

raise TypeError("message")

try:
    operation()
except TypeError as exc:
    print(exc)

TypeError é uma exceção integrada que é lançada quando o tipo de um objeto não é adequado para uma operação ou função. Por exemplo, "7" + 3 não combina automaticamente texto com um número.

Distinga um tipo inadequado (TypeError) de um tipo aceitável com um valor inadequado (ValueError). O seu código pode usar raise TypeError("message") quando uma operação não é suportada para um objeto. Por outro lado, NotImplementedError diz respeito a uma operação que se pretende suportar, mas cuja implementação ainda está em falta.

Para diagnosticar o erro, examine a mensagem e o traceback para localizar a operação que falhou. Capture TypeError apenas onde puder reagir de forma útil; não oculte erros inesperados com um bloco geral except Exception.

No exemplo, except TypeError trata a operação que falhou. Em seguida, int("7") + 3 produz uma soma numérica, enquanto "7" + str(3) concatena cadeias de caracteres. Escolha a conversão que corresponde à intenção do programa, em vez de se limitar a eliminar a exceção.

Exemplos

try:
    result = "7" + 3
except TypeError:
    print("TypeError")

print(int("7") + 3)
print("7" + str(3))

Resultado

TypeError
10
73

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.

Fontes