База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

NumberFormatException — неуспешно преобразуване на текст в число

NumberFormatException показва, че текстът не може да бъде преобразуван до заявения числов тип. При Integer.parseInt причината може да е невалиден запис или стойност извън диапазона на int.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

NumberFormatException от java.lang означава неуспешно преобразуване на текст до числов тип. Тя наследява IllegalArgumentException и е непроверявано изключение: компилаторът не изисква то да бъде прихванато или декларирано в throws.

При Integer.parseInt(text) основата по подразбиране е 10. Допуска се начален знак + или -, но празни символи, празен текст и знаци, които не са валидни цифри, причиняват грешка. Дори валиден числов запис, например "2147483648", причинява NumberFormatException, защото стойността надхвърля диапазона на int. При този метод null също причинява това изключение; не обобщавайте това поведение за всички методи за преобразуване.

Прихващайте NumberFormatException близо до мястото, където се обработват входните данни, и обработвайте изрично отхвърлянето. Не заменяйте стойността незабелязано с нула. Премахвайте околните празни символи само ако правилата за вход го позволяват; това няма да поправи стойност извън диапазона.

Примерът разграничава успешно преобразуване от две грешки: невалиден знак и стойност извън диапазона. Той извежда собствено съобщение, вместо да разчита на текста на съобщението за изключението.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници