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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.