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).
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
fun main() {
val note = mutableListOf(9, 7, 10)
for (i in 0..note.size) {
println(note[i])
}
}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
fun main() {
val comenzi = mutableListOf("A1", "A2")
println(comenzi[comenzi.size])
}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
fun main() {
val zile = mutableListOf("L", "Ma", "Mi")
val i = 5
println(zile[i])
}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ă 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.
fun main() {
val produse = mutableListOf("lapte", "paine", "oua")
for (i in 0..produse.size) {
println("${i + 1}. ${produse[i]}")
}
}1. lapte 2. paine 3. oua
Indiciu
Ultimul index valid este size - 1; folosește lista.indices.
Reparația
fun main() {
val produse = mutableListOf("lapte", "paine", "oua")
for (i in produse.indices) {
println("${i + 1}. ${produse[i]}")
}
}De ce merge
Lista are 3 elemente, cu indecșii 0, 1 și 2. 0..produse.size înseamnă 0..3, iar la i = 3 cererea produse[3] iese din listă, după ce primele trei linii s-au afișat deja. produse.indices este exact 0..2. Alternativ: produse.forEachIndexed { i, p -> println("${i + 1}. $p") }.
Alte forme ale mesajului
java.lang.IndexOutOfBoundsException: Index: 3, Size: 3Exception in thread "main" java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 3java.lang.IndexOutOfBoundsException: Index -1 out of bounds for length 3java.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
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.util.NoSuchElementException: List is empty. Ai apelat first(), last(), max() sau o funcție asemănătoare pe o listă goală. Aceste funcții cer cel puțin un element. Folosește variantele OrNull (firstOrNull(), maxOrNull()) și tratează null, sau verifică înainte isNotEmpty(). Unresolved reference 'add' on receiver of type 'List<Int>' Încerci să adaugi (add, remove, set) într-o listă creată cu listOf, adică o List, care în Kotlin e doar pentru citire. Creeaz-o cu mutableListOf(...) dacă vrei s-o modifici, sau construiește o listă nouă: val noua = lista + 3. Î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.
