...
Eroare Swift · Opționale și nil

error: value of optional type 'Int?' must be unwrapped to a value of type 'Int'

Pe scurt

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

Greșit
SWIFT
let text = "12"
let n = Int(text)
print(n * 2)
Corect
SWIFT
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

Greșit
SWIFT
let preturi = ["lapte": 7, "pâine": 4]
let total = preturi["lapte"] + 3
Corect
SWIFT
let preturi = ["lapte": 7, "pâine": 4]
let total = (preturi["lapte"] ?? 0) + 3

Cheia ar putea lipsi, deci accesul întoarce Int?. Cu ?? 0 alegi ce valoare se folosește atunci.

3max() sau first folosite ca valori sigure

Greșit
SWIFT
let note = [7, 9, 10]
let maxim: Int = note.max()
Corect
SWIFT
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ă tu

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ă.

Codul care dă eroarea
SWIFT
let pretBucata = 12
let cantitateText = "3"
let cantitate = Int(cantitateText)
print("Total: \(pretBucata * cantitate) lei")
După reparație, programul afișează
Total: 36 lei
Indiciu

Int(text) poate eșua, deci întoarce un opțional: despachetează-l cu if let ... else.

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 e nil.
  • Folosește if let / guard let când cazul nil trebuie 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

← 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.