...
Eroare Swift · Struct, class, enum și protocoale

error: switch must be exhaustive

Pe scurt

Un switch din Swift trebuie să trateze toate valorile posibile. Adaugă cazurile care lipsesc (la un enum, toate case-urile) sau un default: care le prinde pe celelalte.

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

Ce înseamnă

În Swift, switch trebuie să fie exhaustiv: pentru orice valoare posibilă trebuie să existe un caz. Mesajul switch must be exhaustive apare când compilatorul găsește valori netratate. Sub el îți spune și ce lipsește: note: add missing case: '.livrata' sau note: add a default clause.

La un enum, poți acoperi toate cazurile fără default, iar asta e chiar recomandat: dacă adaugi mai târziu un caz nou, compilatorul îți arată toate switch-urile care trebuie actualizate.

La Int, String sau tupluri, valorile posibile sunt practic infinite, deci ai mereu nevoie de default (sau de un caz care prinde tot, ca case _: sau case let x:). Același lucru e valabil când folosești intervale: case 0..<5, case 5...10 nu acoperă numerele negative sau pe cele peste 10.

De ce apare: cauzele frecvente

1Enum cu un caz netratat

Greșit
SWIFT
enum Stare { case noua, platita, livrata }
let s = Stare.livrata
switch s {
case .noua: print("nouă")
case .platita: print("plătită")
}
Corect
SWIFT
enum Stare { case noua, platita, livrata }
let s = Stare.livrata
switch s {
case .noua: print("nouă")
case .platita: print("plătită")
case .livrata: print("livrată")
}

Fiecare caz al enum-ului trebuie tratat. Nota de sub eroare îți spune exact care lipsește.

2switch pe Int cu intervale, fără default

Greșit
SWIFT
let nota = 7
switch nota {
case 1..<5: print("Insuficient")
case 5...10: print("Promovat")
}
Corect
SWIFT
let nota = 7
switch nota {
case 1..<5: print("Insuficient")
case 5...10: print("Promovat")
default: print("Notă invalidă")
}

Un Int poate fi și 0, -3 sau 100. default acoperă tot ce nu prind intervalele.

Repară tu

Repară eroarea, direct în pagină

Programul afișează mesajul pentru starea unei comenzi și trebuie să afișeze Comanda a fost livrată, dar compilarea se oprește cu switch must be exhaustive. Adaugă cazul care lipsește pentru livrata, fără default.

Codul care dă eroarea
SWIFT
enum StareComanda {
    case inPregatire
    case expediata
    case livrata
}

let stare = StareComanda.livrata
switch stare {
case .inPregatire:
    print("Comanda se pregătește")
case .expediata:
    print("Comanda a fost expediată")
}
După reparație, programul afișează
Comanda a fost livrată
Indiciu

Enum-ul are trei cazuri, iar switch-ul tratează doar două.

Cum o eviți pe viitor

  • La enum-uri tratează explicit fiecare caz și evită default, ca să afli când apare un caz nou.
  • La numere și texte, pune mereu un default care tratează valorile neașteptate.
  • Citește notele de sub eroare: ele listează cazurile lipsă și le poți adăuga cu Fix în Xcode.
  • În Swift nu e nevoie de break la finalul fiecărui caz: execuția nu trece în cazul următor.

Întrebări frecvente

De ce Swift nu acceptă switch incomplet ca Java sau C?

Ca să nu rămână valori netratate din neatenție. Dacă un enum primește un caz nou, compilatorul îți arată imediat fiecare switch care trebuie actualizat.

Ce pun într-un caz în care nu fac nimic?

Un caz din Swift nu poate fi gol. Scrie break: default: break.

Erori înrudite

← Toate erorile Swift

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ță Swift de la zero, cu exerciții la fiecare lecție

Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.