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.