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

For-loop range must have an 'iterator()' method

Pe scurt

Parcurgi cu for un obiect care nu e colecție, interval sau text: de exemplu o clasă proprie care conține o listă, sau un număr. Parcurge lista din interior (for (p in cos.produse)), folosește un interval (0 until n) sau adaugă clasei operator fun iterator().

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

Ce înseamnă

for (x in ceva) funcționează pe orice obiect care are o funcție operator fun iterator() (membru sau extensie): liste, set-uri, map-uri, array-uri, intervale (1..10), String (pe caractere), secvențe. Compilatorul caută această funcție pe tipul expresiei de după in. Dacă nu o găsește, dă eroarea.

Cazurile tipice:

  • o clasă proprie care ține o listă (Cos, Catalog, Raft): obiectul în sine nu e iterabil, lista din el da;
  • un număr: for (i in 5) în loc de for (i in 0 until 5) (aici Kotlin 2 poate da un mesaj diferit, Method 'iterator()' is ambiguous for this expression);
  • o valoare nullable: for (x in lista) unde lista e List<Int>? (mesaj înrudit despre receiver nullable).

În Kotlin 1.x mesajul era identic.

De ce apare: cauzele frecvente

1Clasă proprie parcursă direct

Greșit
KOTLIN
class Cos(val produse: List<String>)

fun main() {
    for (p in Cos(listOf("pix"))) println(p)
}
Corect
KOTLIN
class Cos(val produse: List<String>)

fun main() {
    for (p in Cos(listOf("pix")).produse) println(p)
}

Lista din obiect are iterator(). Obiectul Cos nu.

2Clasa devine iterabilă

Greșit
KOTLIN
class Raft(val carti: List<String>)

fun main() {
    for (c in Raft(listOf("Ion"))) println(c)
}
Corect
KOTLIN
class Raft(val carti: List<String>) {
    operator fun iterator() = carti.iterator()
}

fun main() {
    for (c in Raft(listOf("Ion"))) println(c)
}

Cu operator fun iterator(), clasa poate apărea direct într-un for. Alternativ, clasa poate implementa Iterable<String>.

3Număr în loc de interval

Greșit
KOTLIN
fun main() {
    val n = 3
    for (i in n) println(i)
}
Corect
KOTLIN
fun main() {
    val n = 3
    for (i in 0 until n) println(i)
}

0 until n este intervalul 0, 1, 2. Un Int singur nu se poate parcurge.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos afișează produsele dintr-un coș, dar nu compilează: For-loop range must have an 'iterator()' method. Repară-l ca să afișeze - paine, - lapte și - oua, fiecare pe linia lui.

Codul care dă eroarea
KOTLIN
class Cos(val produse: List<String>)

fun main() {
    val cos = Cos(listOf("paine", "lapte", "oua"))
    for (p in cos) {
        println("- $p")
    }
}
După reparație, programul afișează
- paine
- lapte
- oua
Indiciu

Parcurge lista produse din obiectul cos (sau adaugă clasei operator fun iterator()).

Alte forme ale mesajului

  • error: for-loop range must have an 'iterator()' method.
  • Method 'iterator()' is ambiguous for this expression
  • Not nullable value required to call an 'iterator()' method on for-loop range

Cum o eviți pe viitor

Când creezi o clasă care ține o colecție și vrei s-o parcurgi des, implementează Iterable<T> sau adaugă operator fun iterator(). Altfel, parcurge explicit proprietatea (cos.produse). Pentru repetări de n ori, folosește repeat(n) { } sau for (i in 0 until n). Pentru liste nullable, lista.orEmpty() dă o listă goală în loc de null.

Întrebări frecvente

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

0..n include și n, deci are n + 1 valori. 0 until n (sau 0..<n) se oprește la n − 1, potrivit pentru indecși.

Merge forEach pe clasa mea dacă adaug iterator()?

Nu direct: forEach e definit pe Iterable. Dacă vrei și funcțiile de colecții (map, filter, forEach), implementează Iterable<T>.

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.