'when' expression must be exhaustive. Add the 'is Err' branch or an 'else' branch.
Faci when pe o sealed class sau pe un enum și ai uitat unul dintre cazuri; compilatorul îți spune exact care: is Err (sau numele valorii din enum). Adaugă ramura lipsă. E mai bine decât un else, pentru că vei fi anunțat și la cazurile adăugate pe viitor.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru sealed class, sealed interface și enum class, Kotlin cunoaște lista completă de subtipuri sau valori. De aceea, la un when folosit ca expresie, poate verifica dacă ai tratat fiecare caz și îți spune exact ce lipsește: Add the 'is Err' branch (pentru o subclasă a unei sealed class) sau Add the 'VERDE' branch (pentru o valoare de enum).
Din Kotlin 1.7, regula se aplică și when-urilor folosite ca instrucțiune pe sealed/enum/Boolean, nu doar celor care întorc o valoare.
Ai două reparații: adaugi ramura cerută (recomandat) sau pui un else. Cu else, când cineva adaugă o subclasă nouă (de exemplu Loading), compilatorul nu te mai avertizează, iar cazul nou intră tăcut pe ramura else. Ramurile explicite păstrează verificarea.
De ce apare: cauzele frecvente
1Subclasă uitată într-o sealed class
sealed class Rezultat
class Succes(val date: String) : Rezultat()
class Eroare(val mesaj: String) : Rezultat()
fun afiseaza(r: Rezultat) = when (r) {
is Succes -> "OK: ${r.date}"
}sealed class Rezultat
class Succes(val date: String) : Rezultat()
class Eroare(val mesaj: String) : Rezultat()
fun afiseaza(r: Rezultat) = when (r) {
is Succes -> "OK: ${r.date}"
is Eroare -> "Eroare: ${r.mesaj}"
}Fiecare subclasă are ramura ei, iar în ramură r este deja convertit la subclasa respectivă (smart cast).
2Valoare de enum netratată
enum class Status { NOUA, LIVRATA, ANULATA }
fun text(s: Status) = when (s) {
Status.NOUA -> "in asteptare"
Status.LIVRATA -> "livrata"
}enum class Status { NOUA, LIVRATA, ANULATA }
fun text(s: Status) = when (s) {
Status.NOUA -> "in asteptare"
Status.LIVRATA -> "livrata"
Status.ANULATA -> "anulata"
}Compilatorul cere Add the 'ANULATA' branch. Cu toate valorile tratate, else nu mai e necesar.
Repară eroarea, direct în pagină
Funcția mesaj de mai jos dă eroarea 'when' expression must be exhaustive, pentru că nu tratează plata respinsă. Adaugă ramura lipsă (fără else), ca programul să afișeze Plata acceptata: 150 lei și Plata respinsa: fonduri insuficiente.
sealed class Plata
class Acceptata(val suma: Int) : Plata()
class Respinsa(val motiv: String) : Plata()
fun mesaj(p: Plata): String = when (p) {
is Acceptata -> "Plata acceptata: ${p.suma} lei"
}
fun main() {
println(mesaj(Acceptata(150)))
println(mesaj(Respinsa("fonduri insuficiente")))
}Plata acceptata: 150 lei Plata respinsa: fonduri insuficiente
Indiciu
Compilatorul îți spune numele subclasei care lipsește: adaugă o ramură is pentru ea.
Reparația
sealed class Plata
class Acceptata(val suma: Int) : Plata()
class Respinsa(val motiv: String) : Plata()
fun mesaj(p: Plata): String = when (p) {
is Acceptata -> "Plata acceptata: ${p.suma} lei"
is Respinsa -> "Plata respinsa: ${p.motiv}"
}
fun main() {
println(mesaj(Acceptata(150)))
println(mesaj(Respinsa("fonduri insuficiente")))
}De ce merge
Plata este sealed, deci are exact două subclase: Acceptata și Respinsa. when trata doar prima, iar compilatorul a cerut explicit Add the 'is Respinsa' branch. Cu ramura is Respinsa, toate cazurile sunt acoperite, iar în ramură p este automat de tip Respinsa, deci p.motiv e accesibil.
Alte forme ale mesajului
error: 'when' expression must be exhaustive. Add the 'is Err' branch or an 'else' branch.'when' expression must be exhaustive, add necessary 'is Eroare' branch or 'else' branch instead'when' expression must be exhaustive. Add the 'ANULATA' branch or an 'else' branch.
Cum o eviți pe viitor
Modelează stările cu sealed class / sealed interface sau enum și tratează-le cu when fără else. Când adaugi un caz nou, compilatorul îți arată toate locurile din program care trebuie actualizate: e una dintre cele mai utile verificări din Kotlin. Pentru subclasele fără date, folosește object (de exemplu object Loading : Stare()) și ramura fără is: Loading -> ....
Întrebări frecvente
Când folosesc is și când nu?
Pentru subclase (class Eroare(...) : Rezultat()) scrii is Eroare. Pentru object și valori de enum scrii direct numele: Loading ->, Status.NOUA ->.
E greșit să pun else?
Nu e greșit, dar pierzi verificarea pentru cazurile adăugate pe viitor. La sealed class și enum, preferă ramurile explicite.
Erori înrudite
'when' expression must be exhaustive. Add an 'else' branch. 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. Class 'Cerc' is not abstract and does not implement abstract member: fun arie(): Double Clasa ta implementează o interfață sau moștenește o clasă abstractă, dar nu scrie una dintre funcțiile (sau proprietățile) abstracte cerute; mesajul spune care: fun arie(): Double. Adaugă override fun arie(): Double = ... în clasă. 'if' must have both main and 'else' branches when used as an expression Folosești if ca expresie (val x = if (...) a), dar fără else. O expresie trebuie să dea mereu o valoare, deci când condiția e falsă ai nevoie de ramura else: val x = if (cond) a else b. Î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.
