Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje