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.