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

java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 3

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Indecșii în Kotlin încep de la 0, deci ultimul element al unei liste de lungime n are indexul n - 1. Mesajul spune exact ce s-a întâmplat: Index 3 out of bounds for length 3 înseamnă că ai cerut indexul 3 dintr-o listă cu 3 elemente.

Excepția vine din ArrayList.get, adică din lista[i] pe o MutableList (sau pe o listă construită cu map, filter). La arrayOf(...) și listOf(a, b, c) primești varianta ArrayIndexOutOfBoundsException, cu același mesaj. La texte, "abc"[5] dă StringIndexOutOfBoundsException.

Cauzele tipice: bucla for (i in 0..lista.size) (inclusiv capătul), lista[lista.size] în loc de lista.last(), sau un index calculat greșit. Stiva arată linia: at MainKt.main(main.kt:5). Index negativ (Index -1) înseamnă de obicei un indexOf care n-a găsit elementul.

De ce apare: cauzele frecvente

1Bucla merge până la size inclusiv

Greșit
KOTLIN
fun main() {
    val note = mutableListOf(9, 7, 10)
    for (i in 0..note.size) {
        println(note[i])
    }
}
Corect
KOTLIN
fun main() {
    val note = mutableListOf(9, 7, 10)
    for (i in note.indices) {
        println(note[i])
    }
}

0..note.size include 3. note.indices (sau 0 until note.size) se oprește la 2.

2Ultimul element cerut cu size

Greșit
KOTLIN
fun main() {
    val comenzi = mutableListOf("A1", "A2")
    println(comenzi[comenzi.size])
}
Corect
KOTLIN
fun main() {
    val comenzi = mutableListOf("A1", "A2")
    println(comenzi.last())
}

Ultimul index este size - 1. last() îl dă direct, iar lastOrNull() merge și pe listă goală.

3Index posibil invalid

Greșit
KOTLIN
fun main() {
    val zile = mutableListOf("L", "Ma", "Mi")
    val i = 5
    println(zile[i])
}
Corect
KOTLIN
fun main() {
    val zile = mutableListOf("L", "Ma", "Mi")
    val i = 5
    println(zile.getOrNull(i) ?: "zi inexistenta")
}

getOrNull întoarce null în loc să arunce excepția.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos se oprește cu IndexOutOfBoundsException: Index 3 out of bounds for length 3. Repară limitele buclei ca programul să afișeze cele trei produse numerotate: 1. lapte, 2. paine, 3. oua.

Codul care dă eroarea
KOTLIN
fun main() {
    val produse = mutableListOf("lapte", "paine", "oua")
    for (i in 0..produse.size) {
        println("${i + 1}. ${produse[i]}")
    }
}
După reparație, programul afișează
1. lapte
2. paine
3. oua
Indiciu

Ultimul index valid este size - 1; folosește lista.indices.

Alte forme ale mesajului

  • java.lang.IndexOutOfBoundsException: Index: 3, Size: 3
  • Exception in thread "main" java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 3
  • java.lang.IndexOutOfBoundsException: Index -1 out of bounds for length 3
  • java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 3

Cum o eviți pe viitor

Evită indecșii scriși de mână: parcurge listele cu for (x in lista), forEach sau forEachIndexed { i, x -> }. Când chiar ai nevoie de index, folosește lista.indices sau 0 until lista.size, nu 0..lista.size. Pentru acces la un index care poate lipsi, getOrNull(i) și getOrElse(i) { implicit } sunt variantele sigure.

Întrebări frecvente

De ce primesc Index: 3, Size: 3 și nu Index 3 out of bounds?

Sunt aceeași eroare, în versiuni diferite de Java. Versiunile vechi (Java 8) afișau Index: 3, Size: 3; cele noi afișează Index 3 out of bounds for length 3.

Ce diferență e între 0..n și 0 until n?

0..n include n, 0 until n (sau 0..<n) se oprește la n - 1. Pentru indecși vrei aproape mereu until sau indices.

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.