CKTIS / Java
NumberFormatException — neúspešný prevod textu na číslo
NumberFormatException signalizuje, že text nemožno previesť na požadovaný číselný typ. Pri Integer.parseInt môže byť príčinou neplatný zápis alebo hodnota mimo rozsahu typu int.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
try {
int value = Integer.parseInt(text);
} catch (NumberFormatException e) {
// Handle invalid numeric input.
}NumberFormatException z java.lang označuje neúspešný prevod textu na číselný typ. Dedí z IllegalArgumentException a je nekontrolovaná: kompilátor nevyžaduje jej zachytenie ani deklaráciu v throws.
Pri Integer.parseInt(text) je predvolený základ 10. Počiatočné znamienko + alebo - je povolené, ale medzery, prázdny text a iné než platné číslice spôsobia chybu. Aj platný zápis čísla, napríklad "2147483648", vyvolá NumberFormatException, pretože hodnota prekračuje rozsah int. Pri tejto metóde spôsobí túto výnimku aj null; nevzťahujte toto správanie všeobecne na všetky konverzné metódy.
Zachyťte NumberFormatException blízko miesta, kde sa spracúvajú vstupné údaje, a odmietnutie riešte výslovne. Nenahrádzajte hodnotu potichu nulou. Okolité medzery odstráňte iba vtedy, ak to pravidlá vstupu povoľujú; hodnotu mimo rozsahu tým neopravíte.
Príklad odlišuje úspešný prevod od dvoch chýb: nepovoleného znaku a hodnoty mimo rozsahu. Vypisuje vlastnú správu namiesto toho, aby sa spoliehal na text správy výnimky.
Prí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ýsledok
42 -> 42 12x -> invalid int 2147483648 -> invalid int
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.