...
Eroare Kotlin · when, if și funcții

'when' expression must be exhaustive. Add an 'else' branch.

Pe scurt

Folosești when ca expresie (îi iei rezultatul într-o variabilă sau într-un return), dar ramurile nu acoperă toate valorile posibile. Pentru Int, String sau Double asta înseamnă că trebuie o ramură else -> ..., care dă rezultatul pentru restul cazurilor.

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

Ce înseamnă

Când when produce o valoare (val s = when (x) { ... }, return when ..., fun f() = when ...), Kotlin trebuie să știe ce valoare iese pentru orice intrare. Pentru tipuri cu infinit de valori (Int, String, Double) nicio listă de ramuri nu le poate acoperi pe toate, deci ai nevoie de else.

La enum class, sealed class și Boolean, compilatorul cunoaște toate cazurile, iar else nu e obligatoriu dacă le tratezi pe fiecare. Mesajul spune atunci concret ce lipsește: Add the 'is Err' branch or an 'else' branch. (vezi pagina separată).

Când when este doar o instrucțiune (nu folosești rezultatul, de exemplu fiecare ramură face un println), else nu e obligatoriu pentru tipuri ca Int. Atenție: un range ca in 1..4 nu acoperă alte numere, chiar dacă tu știi că nota e mereu între 1 și 10.

De ce apare: cauzele frecvente

1Calificativ calculat fără else

Greșit
KOTLIN
fun main() {
    val nota = 7
    val calificativ = when (nota) {
        in 9..10 -> "Foarte bine"
        in 7..8 -> "Bine"
        in 5..6 -> "Suficient"
    }
    println(calificativ)
}
Corect
KOTLIN
fun main() {
    val nota = 7
    val calificativ = when (nota) {
        in 9..10 -> "Foarte bine"
        in 7..8 -> "Bine"
        in 5..6 -> "Suficient"
        else -> "Insuficient"
    }
    println(calificativ)
}

Pentru Int mai există valori (sub 5, peste 10). else le acoperă pe toate.

2when cu String

Greșit
KOTLIN
fun pret(produs: String): Int = when (produs) {
    "cafea" -> 9
    "ceai" -> 7
}
Corect
KOTLIN
fun pret(produs: String): Int = when (produs) {
    "cafea" -> 9
    "ceai" -> 7
    else -> 0
}

Un String poate fi orice text, deci ai nevoie de un rezultat și pentru celelalte. Poți și arunca o excepție: else -> error("Produs necunoscut").

Repară tu

Repară eroarea, direct în pagină

Funcția anotimp de mai jos dă eroarea 'when' expression must be exhaustive. Adaugă ramura care lipsește, ca pentru orice număr care nu e o lună validă să întoarcă luna invalida. Programul trebuie să afișeze vara și apoi luna invalida.

Codul care dă eroarea
KOTLIN
fun anotimp(luna: Int): String = when (luna) {
    12, 1, 2 -> "iarna"
    in 3..5 -> "primavara"
    in 6..8 -> "vara"
    in 9..11 -> "toamna"
}

fun main() {
    println(anotimp(7))
    println(anotimp(13))
}
După reparație, programul afișează
vara
luna invalida
Indiciu

Pentru Int ai nevoie de o ramură else la final.

Alte forme ale mesajului

  • 'when' expression must be exhaustive, add necessary 'else' branch
  • error: 'when' expression must be exhaustive. Add an 'else' branch.
  • 'when' expression must be exhaustive. Add the 'VERDE' branch or an 'else' branch.

Cum o eviți pe viitor

Când scrii un when care întoarce o valoare, scrie de la început și ramura else (sau, la enum și sealed class, câte o ramură pentru fiecare caz). Pune în else ce e corect pentru program: o valoare implicită sau error("...") / throw IllegalArgumentException(...) dacă valoarea n-ar trebui să apară. Pentru stări cu număr fix de cazuri, folosește enum sau sealed class în loc de String sau Int: compilatorul te anunță când adaugi un caz nou și uiți să-l tratezi.

Întrebări frecvente

De ce la enum nu am nevoie de else?

Compilatorul știe toate valorile unui enum. Dacă ai câte o ramură pentru fiecare, when e exhaustiv. Dacă adaugi mai târziu o valoare nouă, primești eroarea exact unde trebuie s-o tratezi.

Am pus ramuri pentru toate numerele care mă interesează. De ce tot cere else?

Compilatorul nu știe că valoarea ta e mereu, de exemplu, între 1 și 12. Pentru el, un Int poate fi orice, inclusiv -5 sau 1000.

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.