...
Eroare Kotlin · Colecții și indecși

java.lang.StringIndexOutOfBoundsException: Range [0, 10) out of bounds for length 3

Pe scurt

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ă

Greșit
KOTLIN
fun main() {
    val titlu = "Mouse"
    println(titlu.substring(0, 10) + "...")
}
Corect
KOTLIN
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

Greșit
KOTLIN
fun main() {
    val email = "ana.exemplu.ro"
    println(email.substring(email.indexOf('@') + 1, 2))
}
Corect
KOTLIN
fun main() {
    val email = "ana.exemplu.ro"
    println(email.substringAfter('@', "(fara domeniu)"))
}

substringAfter tratează singur cazul în care separatorul lipsește.

Repară tu

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.

Codul care dă eroarea
KOTLIN
fun main() {
    val produse = listOf("Televizor", "Pix")
    for (p in produse) {
        println(p.substring(0, 8))
    }
}
După reparație, programul afișează
Televizo
Pix
Indiciu

take(8) întoarce cel mult 8 caractere și merge și pe texte mai scurte.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.StringIndexOutOfBoundsException: Range [0, 10) out of bounds for length 3
  • java.lang.StringIndexOutOfBoundsException: begin 0, end 10, length 3
  • java.lang.StringIndexOutOfBoundsException: Range [5, 3) out of bounds for length 3
  • java.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

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