TypeError, ValueError e a turma dos erros mais comuns

TypeError versus ValueError: tipo ou conteúdo?

Dois erros dominam a vida de quem trabalha com input e conversão, e eles parecem irmãos gêmeos até você olhar de perto. O TypeError reclama do tipo do dado: a operação em si não funciona com aquela categoria de valor, não importa o conteúdo. Somar texto com número é o caso clássico, e você já esbarrou nele no módulo 5.

idade = "25"          # input() sempre devolve texto
daqui_dez = idade + 10  # TypeError: can only concatenate str (not "int") to str

TypeError: o conteúdo até parece número, mas o TIPO é texto, e texto não soma com int.

Já o ValueError reclama do conteúdo. O tipo estava certo, a função aceita texto de entrada, mas aquele texto específico não serve para a operação pedida. É o que acontece quando int() recebe uma palavra: converter texto em número é permitido, desde que o texto contenha um número.

numero = int("25")    # funciona: o texto contém um número
numero = int("abc")   # ValueError: invalid literal for int() with base 10: 'abc'

ValueError: int() aceita texto, mas o valor abc não tem número nenhum para extrair.

NameError e ZeroDivisionError: os outros dois da turma

O NameError é o mais honesto dos quatro: você usou um nome que o Python não conhece. Em nove de cada dez casos, a causa é erro de digitação, uma letra trocada entre a criação da variável e o uso dela. Lembre que o Python diferencia maiúsculas de minúsculas: nome, Nome e NOME são três variáveis diferentes. As versões atuais até sugerem a correção quando existe um nome parecido.

nome = "Ana"
print(nomme)  # NameError: name 'nomme' is not defined. Did you mean: 'nome'?

NameError com sugestão: o Python percebeu que nomme parece nome e ofereceu a pista.

O ZeroDivisionError dispensa tradução: divisão por zero, que não existe na matemática nem no Python. O detalhe importante é onde procurar a correção. A linha apontada pelo traceback é a da divisão, mas ela raramente é a culpada; o problema real é o caminho que deixou um zero chegar como divisor. Um usuário que digitou zero itens, uma lista vazia na hora de calcular média, um contador que não andou. A correção quase sempre é conferir o divisor antes de dividir.

soma = 0
quantidade = 0
media = soma / quantidade  # ZeroDivisionError: division by zero

A divisão está escrita corretamente; o defeito é a quantidade valendo zero ao chegar aqui.

A tabela dos cinco: causa e correção

Somando o SyntaxError da aula 1 aos quatro desta aula, temos o time que responde pela grande maioria das quebras de programa no nível básico. A tabela abaixo é material de consulta: volte a ela sempre que um traceback aparecer, até decorar pelo uso. Repare que a coluna de correção tem um padrão: erros de escrita se corrigem olhando o código; erros de dado se corrigem validando a entrada ou tratando a exceção, que é o assunto da próxima aula.

Uma observação honesta: o Python tem dezenas de outros tipos de exceção, como IndexError para posições que não existem em listas e KeyError para chaves ausentes em dicionários, que você já viu de relance nos módulos 10 e 11. Não precisa decorar o catálogo inteiro. O método é o mesmo para todos: ler o tipo, ler a mensagem, achar a linha. Os cinco da tabela cobrem o seu dia a dia atual.