...
Eroare Kotlin · Excepții la rulare

kotlin.NotImplementedError: An operation is not implemented.

Pe scurt

Programul a ajuns la un TODO() din cod: o funcție sau o ramură lăsată neterminată. TODO() aruncă intenționat NotImplementedError. Scrie implementarea reală în locul lui TODO(); IntelliJ și Android Studio pun des TODO în codul generat automat.

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

Ce înseamnă

TODO() este o funcție din biblioteca standard Kotlin care aruncă mereu kotlin.NotImplementedError: An operation is not implemented.. Cu un motiv, TODO("calculează reducerea"), mesajul devine An operation is not implemented: calculează reducerea.

E util în timp ce scrii codul: compilează în orice context (are tipul Nothing, deci se potrivește cu orice tip de return), iar la rulare te oprește exact acolo unde ai lăsat lucrul neterminat.

Cel mai des îl primești din cod generat automat: când IntelliJ / Android Studio implementează membrii unei interfețe (Implement Members), corpul fiecărei funcții este TODO("Not yet implemented"). Dacă uiți să-l înlocuiești, programul se oprește la primul apel. Stiva arată funcția cu TODO și linia de unde a fost apelată.

De ce apare: cauzele frecvente

1Cod generat automat, necompletat

Greșit
KOTLIN
interface Forma {
    fun arie(): Double
}

class Patrat(val latura: Double) : Forma {
    override fun arie(): Double {
        TODO("Not yet implemented")
    }
}

fun main() {
    println(Patrat(2.0).arie())
}
Corect
KOTLIN
interface Forma {
    fun arie(): Double
}

class Patrat(val latura: Double) : Forma {
    override fun arie(): Double = latura * latura
}

fun main() {
    println(Patrat(2.0).arie())
}

Editorul a pus TODO ca loc de completat. Implementarea reală îl înlocuiește.

2Ramură lăsată pentru mai târziu

Greșit
KOTLIN
fun cost(metoda: String): Int = when (metoda) {
    "curier" -> 20
    else -> TODO()
}

fun main() {
    println(cost("ridicare"))
}
Corect
KOTLIN
fun cost(metoda: String): Int = when (metoda) {
    "curier" -> 20
    "ridicare" -> 0
    else -> error("Metoda necunoscuta: $metoda")
}

fun main() {
    println(cost("ridicare"))
}

Cazurile cunoscute au valori, iar pentru restul error(...) dă un mesaj clar, nu un TODO uitat.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos se oprește cu kotlin.NotImplementedError: An operation is not implemented, pentru că metoda de calcul a fost lăsată cu TODO. Implementeaz-o: perimetrul unui dreptunghi este 2 x (lungime + lățime). Programul trebuie să afișeze Perimetru: 14.0.

Codul care dă eroarea
KOTLIN
class Dreptunghi(val lungime: Double, val latime: Double) {
    fun perimetru(): Double {
        TODO("Not yet implemented")
    }
}

fun main() {
    val d = Dreptunghi(4.0, 3.0)
    println("Perimetru: ${d.perimetru()}")
}
După reparație, programul afișează
Perimetru: 14.0
Indiciu

Înlocuiește TODO cu expresia 2 * (lungime + latime).

Alte forme ale mesajului

  • kotlin.NotImplementedError: An operation is not implemented: Not yet implemented
  • Exception in thread "main" kotlin.NotImplementedError: An operation is not implemented.
  • kotlin.NotImplementedError: An operation is not implemented: calculeaza reducerea

Cum o eviți pe viitor

După ce generezi cod automat, caută în proiect TODO( și completează-le pe toate (în IntelliJ / Android Studio fereastra TODO le listează). Folosește TODO() doar temporar, cu un motiv scris, și nu-l lăsa în codul pe care îl predai. Pentru cazuri care chiar nu trebuie să apară, folosește error("...") sau throw IllegalArgumentException(...) cu un mesaj explicit.

Întrebări frecvente

De ce TODO() compilează în orice funcție, indiferent de tipul de return?

TODO() are tipul Nothing, care este subtip al oricărui tip. Compilatorul știe că funcția nu se întoarce niciodată normal (aruncă mereu), deci acceptă apelul oriunde.

E un comentariu // TODO același lucru?

Nu. // TODO e doar un comentariu, nu face nimic la rulare. TODO() este un apel de funcție care oprește programul.

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.