java.lang.NumberFormatException: Value out of range. Value:"300" Radix:10
Textul conține un număr valid, dar prea mare (sau prea mic) pentru tipul în care îl convertești: Byte.parseByte acceptă doar -128..127, Short.parseShort doar -32768..32767. Folosește un tip mai mare, de obicei Integer.parseInt.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Byte.parseByte și Short.parseShort citesc textul ca int, apoi verifică dacă valoarea încape în tipul cerut. Dacă nu încape, aruncă NumberFormatException cu un mesaj diferit de cel obișnuit: Value out of range. Value:"300" Radix:10. Îți spune textul primit și baza de numerație (10 = zecimal).
Intervalele de reținut:
byte: de la -128 la 127;short: de la -32768 la 32767;int: aproximativ ±2,1 miliarde;long: aproximativ ±9,2 × 10^18.
Pentru Integer.parseInt și Long.parseLong, depășirea are mesajul clasic For input string: "3000000000". Când vezi Value out of range, caută un parseByte sau parseShort în linia din stivă: aproape sigur ai ales un tip prea mic pentru datele reale (vârste, procente, cantități care pot crește).
De ce apare: cauzele frecvente
1byte pentru o cantitate
byte cantitate = Byte.parseByte("300");int cantitate = Integer.parseInt("300");300 depășește 127, maximul unui byte. int acoperă orice cantitate obișnuită.
2short pentru un cod poștal sau un preț în bani
short pretBani = Short.parseShort("45900");int pretBani = Integer.parseInt("45900");45900 trece de 32767. Economia de memorie a lui short nu merită riscul.
3Octet citit ca text fără semn
byte b = Byte.parseByte("255");byte b = (byte) Integer.parseInt("255");În Java, byte are semn. Dacă textul reprezintă un octet 0..255, citește-l ca int și convertește explicit.
Repară eroarea, direct în pagină
Programul citește cantitățile dintr-o comandă și le adună, dar se oprește cu NumberFormatException: Value out of range. Value:"300" Radix:10. Schimbă tipul folosit la conversie, ca programul să afișeze Total bucati: 420.
public class Main {
public static void main(String[] args) {
String[] cantitati = {"120", "300"};
int total = 0;
for (String c : cantitati) {
byte bucati = Byte.parseByte(c);
total += bucati;
}
System.out.println("Total bucati: " + total);
}
}Total bucati: 420
Indiciu
Un byte ține doar până la 127; folosește int și Integer.parseInt.
Reparația
public class Main {
public static void main(String[] args) {
String[] cantitati = {"120", "300"};
int total = 0;
for (String c : cantitati) {
int bucati = Integer.parseInt(c);
total += bucati;
}
System.out.println("Total bucati: " + total);
}
}De ce merge
Byte.parseByte("120") reușea, dar "300" depășea maximul 127 al tipului byte, iar metoda a aruncat excepția cu valoarea și baza de numerație. Integer.parseInt acceptă valori de până la aproximativ 2,1 miliarde, deci ambele cantități se convertesc, iar suma lor este 420.
Alte forme ale mesajului
java.lang.NumberFormatException: Value out of range. Value:"40000" Radix:10java.lang.NumberFormatException: Value out of range. Value:"-200" Radix:10java.lang.NumberFormatException: Value out of range. Value:"ff" Radix:16
Cum o eviți pe viitor
- Folosește
intșilongpentru numere din date reale;byteșishortdoar când formatul chiar o cere. - Validează intervalul după conversie, cu mesaje clare pentru utilizator (de exemplu „vârsta trebuie să fie între 0 și 120”).
- Prinde
NumberFormatExceptionla orice conversie din text venit din afară. - Pentru sume de bani, folosește
long(în bani) sauBigDecimal.
Întrebări frecvente
De ce nu primesc For input string, ca de obicei?
Pentru că textul e un număr valid. parseByte și parseShort îl citesc întâi ca int și abia apoi descoperă că nu încape, așa că raportează intervalul depășit.
Și (byte) 300 ce dă?
44. Conversia explicită nu aruncă excepție, dar taie biții în plus, deci obții o valoare greșită fără niciun avertisment.
Erori înrudite
java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. error: incompatible types: possible lossy conversion from double to int Încerci să pui o valoare double (cu zecimale) într-o variabilă int, iar Java nu face singur conversia pentru că s-ar pierde zecimalele. Folosește o variabilă double sau convertește explicit: (int) valoare ori (int) Math.round(valoare). java.lang.ArithmeticException: integer overflow O metodă ...Exact (Math.addExact, multiplyExact, toIntExact) a observat că rezultatul nu încape în int și a oprit programul în loc să dea un număr greșit. Fă calculul în long (sau BigInteger pentru valori foarte mari). Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
