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

CKTIS / Java

NumberFormatException — falha na conversão de texto para número

NumberFormatException indica que o texto não pode ser convertido para o tipo numérico pedido. Com Integer.parseInt, a causa pode ser uma representação inválida ou um valor fora do intervalo de int.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

try {
    int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
    // Handle invalid numeric input.
}

NumberFormatException, de java.lang, indica uma falha na conversão de texto para um tipo numérico. Herda de IllegalArgumentException e é não verificada: o compilador não exige que seja capturada nem declarada em throws.

Para Integer.parseInt(text), a base predefinida é 10. É permitido um sinal inicial + ou -, mas espaços em branco, texto vazio e caracteres que não sejam algarismos válidos causam uma falha. Mesmo uma representação numérica válida, como "2147483648", causa NumberFormatException, porque o valor excede o intervalo de int. Neste método, null também causa esta exceção; não generalize este comportamento para todos os métodos de conversão.

Capture NumberFormatException perto do ponto de processamento dos dados de entrada e trate explicitamente a rejeição. Não substitua silenciosamente o valor por zero. Remova os espaços em redor apenas se as regras de entrada o permitirem; isso não resolve um valor fora do intervalo.

O exemplo distingue uma conversão bem-sucedida de duas falhas: um carácter inválido e um valor fora do intervalo. Apresenta uma mensagem própria em vez de depender do texto da mensagem da exceção.

Exemplos

public class Main {
    public static void main(String[] args) {
        String[] inputs = {"42", "12x", "2147483648"};
        for (String text : inputs) {
            try {
                int value = Integer.parseInt(text);
                System.out.println(text + " -> " + value);
            } catch (NumberFormatException e) {
                System.out.println(text + " -> invalid int");
            }
        }
    }
}

Resultado

42 -> 42
12x -> invalid int
2147483648 -> invalid int

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