java.lang.StringIndexOutOfBoundsException: Range [0, 10) out of bounds for length 3
Ai cerut cu substring o bucată de text care iese din string (substring(0, 10) pe un text de 3 caractere). Limitează capătul la lungime: text.take(10), text.substring(0, minOf(10, text.length)), sau verifică length înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
substring(start, end) întoarce caracterele de la start inclusiv până la end exclusiv. Ambele trebuie să fie între 0 și length, iar start <= end. Altfel, JVM-ul aruncă StringIndexOutOfBoundsException.
Mesajul (Java 17+) arată intervalul cerut și lungimea reală: Range [0, 10) out of bounds for length 3 înseamnă că ai cerut caracterele 0..9 dintr-un text de 3. Range [5, 3) înseamnă că start (5) e deja după sfârșit. Versiunile mai vechi de Java afișau begin 0, end 10, length 3.
Apare des la scurtarea textelor pentru afișare (primele 20 de caractere dintr-un titlu), la extragerea unor coduri cu poziție fixă și la indexOf care întoarce -1 și e folosit direct ca index.
De ce apare: cauzele frecvente
1Text mai scurt decât bucata cerută
fun main() {
val titlu = "Mouse"
println(titlu.substring(0, 10) + "...")
}fun main() {
val titlu = "Mouse"
println(titlu.take(10) + if (titlu.length > 10) "..." else "")
}take(n) întoarce cel mult n caractere, fără excepție dacă textul e mai scurt.
2indexOf întoarce -1
fun main() {
val email = "ana.exemplu.ro"
println(email.substring(email.indexOf('@') + 1, 2))
}fun main() {
val email = "ana.exemplu.ro"
println(email.substringAfter('@', "(fara domeniu)"))
}substringAfter tratează singur cazul în care separatorul lipsește.
Repară eroarea, direct în pagină
Programul de mai jos scurtează numele produselor la 8 caractere pentru o etichetă, dar la un nume scurt se oprește cu java.lang.StringIndexOutOfBoundsException: Range [0, 8) out of bounds for length 3. Repară scurtarea ca programul să afișeze Televizo și Pix.
fun main() {
val produse = listOf("Televizor", "Pix")
for (p in produse) {
println(p.substring(0, 8))
}
}Televizo Pix
Indiciu
take(8) întoarce cel mult 8 caractere și merge și pe texte mai scurte.
Reparația
fun main() {
val produse = listOf("Televizor", "Pix")
for (p in produse) {
println(p.take(8))
}
}De ce merge
substring(0, 8) cere exact caracterele 0..7, iar Pix are doar 3, deci capătul 8 iese din text și apare excepția. take(8) întoarce primele cel mult 8 caractere: din Televizor taie la Televizo, iar Pix rămâne întreg. Spre deosebire de substring, take nu are nevoie de nicio verificare a lungimii.
Alte forme ale mesajului
Exception in thread "main" java.lang.StringIndexOutOfBoundsException: Range [0, 10) out of bounds for length 3java.lang.StringIndexOutOfBoundsException: begin 0, end 10, length 3java.lang.StringIndexOutOfBoundsException: Range [5, 3) out of bounds for length 3java.lang.StringIndexOutOfBoundsException: String index out of range: -1
Cum o eviți pe viitor
Pentru tăieri de text folosește funcțiile Kotlin care nu aruncă: take, takeLast, drop, substringBefore, substringAfter, removePrefix. Când chiar ai nevoie de indici, verifică length și rezultatul lui indexOf (-1 înseamnă „nu există”). Testează funcțiile și cu texte goale sau foarte scurte.
Întrebări frecvente
De ce end e exclusiv?
Ca să poți scrie substring(0, text.length) pentru tot textul și substring(a, b) cu lungimea b - a. E aceeași convenție ca la until în intervale.
E aceeași eroare ca la text[10]?
Aceeași clasă de excepție, alt mesaj: la accesul unui singur caracter primești Index 10 out of bounds for length 3, explicat la IndexOutOfBoundsException.
Erori înrudite
java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 3 Ai cerut dintr-o listă elementul de la un index care nu există: lista are 3 elemente (indecșii 0, 1, 2), iar tu ai cerut indexul 3. Verifică limitele buclei (folosește lista.indices sau 0 until size) sau folosește getOrNull(i). java.lang.ArrayIndexOutOfBoundsException: Index 3 out of bounds for length 3 Ai citit dintr-un Array (sau dintr-o listă creată cu listOf, care folosește intern un array) un index care nu există. Pentru 3 elemente indecșii valizi sunt 0, 1, 2. Corectează indexul sau limitele buclei, ori folosește getOrNull(i). 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()). Î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.
