CKTIS / Java
NumberFormatException — nieudana konwersja tekstu na liczbę
NumberFormatException sygnalizuje, że tekstu nie można przekształcić na żądany typ liczbowy. Przy Integer.parseInt przyczyną może być zarówno niepoprawny zapis, jak i wartość poza zakresem int.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
try {
int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
// Handle invalid numeric input.
}NumberFormatException z pakietu java.lang oznacza nieudaną konwersję tekstu na typ liczbowy. Dziedziczy po IllegalArgumentException i jest wyjątkiem niekontrolowanym: kompilator nie wymaga jego przechwycenia ani deklaracji w throws.
Dla Integer.parseInt(text) domyślną podstawą jest 10. Dopuszczalny jest początkowy znak + lub -, ale spacje, pusty tekst i znaki inne niż dozwolone cyfry powodują błąd. Także poprawny zapis liczby, np. "2147483648", powoduje NumberFormatException, ponieważ wartość przekracza zakres int. Dla tej metody również null powoduje ten wyjątek; nie należy uogólniać tego zachowania na wszystkie metody konwersji.
Przechwytuj NumberFormatException blisko miejsca przetwarzania danych wejściowych i jawnie obsługuj odrzucenie wartości. Nie zastępuj jej po cichu zerem. Usuwaj otaczające spacje tylko wtedy, gdy reguły wejścia na to pozwalają; nie naprawi to przekroczenia zakresu.
Przykład oddziela udaną konwersję od dwóch błędów: niedozwolonego znaku i przekroczenia zakresu. Wypisuje własny komunikat zamiast polegać na treści komunikatu wyjątku.
Przykłady
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");
}
}
}
}Wynik
42 -> 42 12x -> invalid int 2147483648 -> invalid int
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.