WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

NumberFormatException — fehlgeschlagene Text-zu-Zahl-Konvertierung

NumberFormatException signalisiert, dass Text nicht in den angeforderten Zahlentyp umgewandelt werden kann. Bei Integer.parseInt kann entweder eine ungültige Schreibweise oder ein Wert außerhalb des int-Bereichs die Ursache sein.

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

Syntax

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

NumberFormatException aus java.lang weist auf eine fehlgeschlagene Konvertierung von Text in einen Zahlentyp hin. Die Klasse erbt von IllegalArgumentException und ist ungeprüft: Der Compiler verlangt weder, dass sie abgefangen wird, noch dass sie in throws deklariert ist.

Bei Integer.parseInt(text) ist die Standardbasis 10. Ein vorangestelltes + oder - ist zulässig. Leerraum, leerer Text und andere Zeichen als zulässige Ziffern führen jedoch zu einem Fehler. Auch eine gültige Zahlenschreibweise wie "2147483648" löst NumberFormatException aus, weil der Wert den int-Bereich überschreitet. Bei dieser Methode führt auch null zu dieser Ausnahme; verallgemeinere dieses Verhalten nicht auf alle Konvertierungsmethoden.

Fange NumberFormatException nahe der Stelle ab, an der Eingaben verarbeitet werden, und behandle die Zurückweisung ausdrücklich. Ersetze den Wert nicht stillschweigend durch die Zahl 0. Entferne umgebenden Leerraum nur, wenn die Eingaberegeln dies erlauben; ein Wert außerhalb des zulässigen Bereichs bleibt dadurch ungültig.

Das Beispiel unterscheidet eine erfolgreiche Konvertierung von zwei Fehlerfällen: einem ungültigen Zeichen und einem Wert außerhalb des zulässigen Bereichs. Es gibt eine eigene Meldung aus, statt sich auf den Text der Ausnahmemeldung zu verlassen.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen