CKTIS / Java
NumberFormatException — conversione da testo a numero non riuscita
NumberFormatException segnala che il testo non può essere convertito nel tipo numerico richiesto. Con Integer.parseInt, la causa può essere una notazione non valida oppure un valore fuori dall’intervallo di int.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
try {
int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
// Handle invalid numeric input.
}NumberFormatException, in java.lang, indica che la conversione da testo a un tipo numerico non è riuscita. Estende IllegalArgumentException ed è non controllata: il compilatore non richiede né di intercettarla né di dichiararla in throws.
Per Integer.parseInt(text), la base predefinita è 10. È consentito un segno iniziale + o -, ma spazi, testo vuoto e caratteri diversi da cifre valide causano un errore. Anche una notazione numerica valida, come "2147483648", causa NumberFormatException, perché il valore supera l’intervallo di int. Per questo metodo, anche null causa questa eccezione; non estendere questo comportamento a tutti i metodi di conversione.
Intercetta NumberFormatException vicino al punto in cui vengono elaborate le informazioni in ingresso e gestisci esplicitamente il rifiuto. Non sostituire il valore con zero senza segnalarlo. Rimuovi gli spazi circostanti solo se le regole di input lo consentono; ciò non risolve un valore fuori intervallo.
L’esempio distingue una conversione riuscita da due errori: un carattere non valido e un valore fuori intervallo. Stampa un messaggio proprio invece di affidarsi al testo del messaggio dell’eccezione.
Esempi
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");
}
}
}
}Risultato
42 -> 42 12x -> invalid int 2147483648 -> invalid int
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.