Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

NumberFormatException — neúspěšný převod textu na číslo

NumberFormatException signalizuje, že text nelze převést na požadovaný číselný typ. U Integer.parseInt může být příčinou neplatný zápis nebo hodnota mimo rozsah typu int.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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

NumberFormatException z java.lang označuje neúspěšný převod textu na číselný typ. Dědí z IllegalArgumentException a je nekontrolovaná: kompilátor nevyžaduje její zachycení ani deklaraci v throws.

U Integer.parseInt(text) je výchozí základ 10. Počáteční znaménko + nebo - je povoleno, ale mezery, prázdný text a jiné než platné číslice způsobí chybu. I platný zápis čísla, například "2147483648", vyvolá NumberFormatException, protože hodnota překračuje rozsah int. U této metody způsobí tuto výjimku také null; nevztahujte toto chování obecně na všechny převodní metody.

Zachyťte NumberFormatException blízko místa, kde se zpracovávají vstupní data, a odmítnutí řešte výslovně. Nenahrazujte hodnotu potichu nulou. Okolní mezery odstraňujte pouze tehdy, pokud to pravidla vstupu dovolují; hodnotu mimo rozsah tím neopravíte.

Příklad odlišuje úspěšný převod od dvou chyb: nepovoleného znaku a hodnoty mimo rozsah. Vypisuje vlastní zprávu, místo aby se spoléhal na text zprávy výjimky.

Příklady

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");
            }
        }
    }
}

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje