...
Eroare Kotlin · Excepții la rulare

java.lang.NumberFormatException: Value out of range. Value:"300" Radix:10

Pe scurt

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

Greșit
KOTLIN
fun main() {
    val rosu = "FF".toByte(16)
    println(rosu)
}
Corect
KOTLIN
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

Greșit
KOTLIN
fun main() {
    val cantitate = "40000".toShort()
    println(cantitate)
}
Corect
KOTLIN
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ă tu

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).

Codul care dă eroarea
KOTLIN
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)")
}
După reparație, programul afișează
RGB(200, 30, 90)
Indiciu

Valorile ajung până la 255, deci nu încap în Byte; folosește toInt(16).

Alte forme ale mesajului

  • Exception in thread "main" java.lang.NumberFormatException: Value out of range. Value:"300" Radix:10
  • java.lang.NumberFormatException: Value out of range. Value:"FF" Radix:16
  • java.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

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.