KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

NumberFormatException — mislukte conversie van tekst naar een getal

NumberFormatException geeft aan dat tekst niet kan worden omgezet naar het gevraagde numerieke type. Bij Integer.parseInt kan de oorzaak een ongeldige notatie zijn of een waarde buiten het bereik van int.

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

Syntax

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

NumberFormatException uit java.lang geeft aan dat de conversie van tekst naar een numeriek type is mislukt. De klasse erft van IllegalArgumentException en is unchecked: de compiler vereist niet dat je de uitzondering opvangt of in throws declareert.

Voor Integer.parseInt(text) is de standaardradix 10. Een voorafgaand +- of --teken is toegestaan, maar witruimte, lege tekst en andere tekens dan geldige cijfers veroorzaken een fout. Ook een geldige getalnotatie, zoals "2147483648", veroorzaakt NumberFormatException, omdat de waarde buiten het bereik van int valt. Bij deze methode veroorzaakt ook null deze uitzondering; trek dit gedrag niet door naar alle conversiemethoden.

Vang NumberFormatException op dicht bij de plek waar invoer wordt verwerkt en behandel de afwijzing expliciet. Vervang de waarde niet ongemerkt door nul. Verwijder omringende witruimte alleen als de invoerregels dat toestaan; daarmee los je een waarde buiten het bereik niet op.

Het voorbeeld onderscheidt een geslaagde conversie van twee fouten: een ongeldig teken en een waarde buiten het bereik. Het geeft een eigen melding weer in plaats van te vertrouwen op de tekst van de uitzonderingsmelding.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen