Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła