error: value of optional type 'Int?' must be unwrapped to a value of type 'Int'
Folosești un opțional (Int?, String?) acolo unde e nevoie de o valoare sigură. Despachetează-l întâi: if let x { ... }, guard let x else { ... }, x ?? valoareImplicita sau, doar dacă ești sigur că nu e nil, x!.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un opțional (Int?) este fie o valoare (Int), fie nil. Swift nu te lasă să faci calcule direct cu el, pentru că valoarea poate lipsi. Mesajul value of optional type 'Int?' must be unwrapped to a value of type 'Int' spune: aici e nevoie de un Int, dar ai un Int?, deci trebuie să-l despachetezi (unwrap).
Cele mai frecvente surse de opționale: Int("12") și Double(text) (textul poate să nu fie număr), dictionar["cheie"] (cheia poate lipsi), lista.first, lista.last, lista.firstIndex(of:), lista.max(), proprietățile declarate cu ?.
Sub eroare compilatorul îți propune două variante: coalesce using '??' (dai o valoare de rezervă) și force-unwrap using '!' (programul se oprește dacă e nil). Pe lângă ele, cele mai sigure sunt if let și guard let, care tratează explicit cazul în care valoarea lipsește.
De ce apare: cauzele frecvente
1Text convertit în număr și folosit direct
let text = "12"
let n = Int(text)
print(n * 2)let text = "12"
if let n = Int(text) {
print(n * 2)
}Int(text) întoarce Int?. if let intră în bloc doar dacă conversia a reușit, iar acolo n e un Int obișnuit.
2Valoare din dicționar folosită în calcul
let preturi = ["lapte": 7, "pâine": 4]
let total = preturi["lapte"] + 3let preturi = ["lapte": 7, "pâine": 4]
let total = (preturi["lapte"] ?? 0) + 3Cheia ar putea lipsi, deci accesul întoarce Int?. Cu ?? 0 alegi ce valoare se folosește atunci.
3max() sau first folosite ca valori sigure
let note = [7, 9, 10]
let maxim: Int = note.max()let note = [7, 9, 10]
guard let maxim = note.max() else { fatalError("listă goală") }
print(maxim)Pentru o listă goală max() întoarce nil. guard let oprește execuția devreme în cazul acesta și lasă maxim despachetat pentru restul codului.
Repară eroarea, direct în pagină
Programul primește cantitatea ca text dintr-un formular și trebuie să afișeze Total: 36 lei (12 lei bucata, cantitatea "3"), dar compilarea se oprește cu value of optional type 'Int?' must be unwrapped to a value of type 'Int'. Repară codul cu if let, iar pentru un text invalid afișează Cantitate invalidă.
let pretBucata = 12
let cantitateText = "3"
let cantitate = Int(cantitateText)
print("Total: \(pretBucata * cantitate) lei")Total: 36 lei
Indiciu
Int(text) poate eșua, deci întoarce un opțional: despachetează-l cu if let ... else.
Reparația
let pretBucata = 12
let cantitateText = "3"
if let cantitate = Int(cantitateText) {
print("Total: \(pretBucata * cantitate) lei")
} else {
print("Cantitate invalidă")
}De ce merge
Int(cantitateText) întoarce Int?, pentru că textul ar putea fi „trei” sau gol. Swift nu permite înmulțirea unui Int cu un Int?. if let verifică dacă există valoare: dacă da, cantitate e un Int obișnuit în blocul if și calculul dă 36; dacă nu, se execută else. Astfel ambele situații sunt tratate explicit, fără riscul unei opriri cu !.
Alte forme ale mesajului
error: value of optional type 'String?' must be unwrapped to a value of type 'String'error: value of optional type 'Double?' must be unwrapped to a value of type 'Double'
Cum o eviți pe viitor
- Când apelezi
Int(...),Double(...),dict[cheie],first,max(), gândește-te imediat ce faci dacă rezultatul enil. - Folosește
if let/guard letcând cazulniltrebuie tratat separat și??când ai o valoare implicită rezonabilă. - Evită
!cu excepția situațiilor în care ești sigur că valoarea există (și chiar atunci, preferăguard let). - Despachetează o singură dată, cât mai devreme, apoi lucrează cu valoarea sigură.
Întrebări frecvente
Care e diferența dintre ?? și !?
x ?? 0 folosește 0 dacă x e nil și programul continuă. x! presupune că valoarea există; dacă e nil, programul se oprește cu Fatal error: Unexpectedly found nil while unwrapping an Optional value.
Pot scrie if let n fără = n?
Da, din Swift 5.7: if let n { ... } este prescurtarea pentru if let n = n { ... }, pentru o variabilă opțională care se numește deja n.
Erori înrudite
error: value of optional type 'String?' must be unwrapped to refer to member 'count' of wrapped base type 'String' Accesezi o proprietate sau o metodă (count, uppercased()) pe un opțional. Folosește optional chaining (nume?.count, care dă tot un opțional), despachetează cu if let / guard let sau dă o valoare implicită cu ??. Fatal error: Unexpectedly found nil while unwrapping an Optional value Programul s-a oprit pentru că ai despachetat cu ! un opțional care era nil (o conversie Int("abc")!, o cheie lipsă dict["x"]!, first! pe o listă goală). Înlocuiește ! cu if let, guard let sau ??, ca să tratezi cazul fără valoare. error: initializer for conditional binding must have Optional type, not 'Int' Folosești if let sau guard let pe o valoare care nu e opțională, deci nu are ce despacheta. Scoate if let și folosește valoarea direct sau, dacă voiai o condiție, scrie un if obișnuit cu comparație. Î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.
