java.lang.NumberFormatException: Value out of range. Value:"300" Radix:10
Textul e un număr valid, dar prea mare (sau prea mic) pentru tipul în care îl convertești: "300".toByte() (Byte merge până la 127), "40000".toShort(). Folosește un tip mai mare (toInt, toLong) sau varianta toByteOrNull() și tratează null.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toByte() și toShort() transformă un text într-un număr cu interval mic: Byte acceptă -128..127, Short acceptă -32768..32767. Dacă textul conține un număr corect, dar în afara intervalului, Java aruncă NumberFormatException cu mesajul Value out of range, urmat de valoarea primită și baza (Radix:10 = zecimal).
E diferit de For input string: "abc", unde textul nu e deloc un număr. Aici formatul e bun, doar tipul e prea mic.
Apare la parsarea datelor binare sau a protocoalelor, la coduri de culoare ("FF".toByte(16) dă eroare, pentru că 255 > 127) și la câmpuri declarate „mici” care primesc valori neașteptate. Pentru Int și Long, depășirea dă For input string: "99999999999".
De ce apare: cauzele frecvente
1Byte pentru valori până la 255
fun main() {
val rosu = "FF".toByte(16)
println(rosu)
}fun main() {
val rosu = "FF".toInt(16)
println(rosu)
}255 nu încape în Byte; Int îl ține fără probleme. Pentru octeți fără semn există toUByte(16).
2Tip prea mic pentru date de la utilizator
fun main() {
val cantitate = "40000".toShort()
println(cantitate)
}fun main() {
val cantitate = "40000".toShortOrNull() ?: Short.MAX_VALUE
println(cantitate)
}toShortOrNull() întoarce null dacă nu poate converti, iar tu decizi ce faci în acel caz.
Repară eroarea, direct în pagină
Programul de mai jos citește componentele unei culori din cod hexazecimal, dar se oprește cu java.lang.NumberFormatException: Value out of range. Value:"C8" Radix:16. Repară conversiile ca programul să afișeze RGB(200, 30, 90).
fun main() {
val hex = "C81E5A"
val r = hex.substring(0, 2).toByte(16)
val g = hex.substring(2, 4).toByte(16)
val b = hex.substring(4, 6).toByte(16)
println("RGB($r, $g, $b)")
}RGB(200, 30, 90)
Indiciu
Valorile ajung până la 255, deci nu încap în Byte; folosește toInt(16).
Reparația
fun main() {
val hex = "C81E5A"
val r = hex.substring(0, 2).toInt(16)
val g = hex.substring(2, 4).toInt(16)
val b = hex.substring(4, 6).toInt(16)
println("RGB($r, $g, $b)")
}De ce merge
C8 în baza 16 înseamnă 200, dar Byte merge doar până la 127, deci parsarea refuză valoarea, deși textul e un număr hexazecimal corect. toInt(16) folosește un tip suficient de mare: C8 = 200, 1E = 30, 5A = 90.
Alte forme ale mesajului
Exception in thread "main" java.lang.NumberFormatException: Value out of range. Value:"300" Radix:10java.lang.NumberFormatException: Value out of range. Value:"FF" Radix:16java.lang.NumberFormatException: Value out of range. Value:"40000" Radix:10
Cum o eviți pe viitor
Folosește Int ca tip implicit pentru numere întregi și Long pentru valori mari (sume în bani, ID-uri, timestamp-uri). Byte și Short sunt potrivite doar pentru date binare. Pentru orice conversie din text venit din afară, folosește variantele ...OrNull() și tratează explicit cazul null.
Întrebări frecvente
De ce "200".toByte() dă eroare, dar 200.toByte() dă -56?
Conversia între tipuri numerice (Int.toByte()) păstrează doar ultimii 8 biți, fără verificare. Parsarea din text (String.toByte()) verifică intervalul și aruncă excepție.
Ce înseamnă Radix?
Baza de numerație: 10 pentru zecimal, 16 pentru hexazecimal, 2 pentru binar. O dai ca argument: "1010".toInt(2).
Erori înrudite
java.lang.NumberFormatException: For input string: "abc" Ai apelat toInt() (sau toDouble(), toLong()) pe un text care nu e un număr valid: "abc", "12.5" pentru Int, "" sau " 7" cu spații. Folosește toIntOrNull() și tratează null, sau curăță textul înainte (trim()). java.lang.ArithmeticException: integer overflow Un calcul cu Math.addExact, multiplyExact sau toIntExact a depășit valoarea maximă a lui Int (2147483647). Funcțiile Exact aruncă excepția ca să nu primești un rezultat greșit. Fă calculul în Long (sau BigInteger pentru valori uriașe). Initializer type mismatch: expected 'Int', actual 'String' Ai declarat o variabilă cu un tip (Int) și i-ai dat la inițializare o valoare de alt tip (String). Kotlin nu convertește automat între tipuri. Schimbă valoarea, schimbă tipul declarat sau convertește explicit, de exemplu cu "5".toInt(). Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
