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

error: value of optional type 'String?' must be unwrapped to refer to member 'count' of wrapped base type 'String'

Pe scurt

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

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

Ce înseamnă

Mesajul e varianta lui must be unwrapped pentru accesul la membri. value of optional type 'String?' must be unwrapped to refer to member 'count' of wrapped base type 'String' înseamnă: count există pe String, dar tu ai un String?, care poate fi nil, iar pe nil nu există count.

Ai trei variante, după ce vrei:

  • optional chaining: nume?.count dă Int?, adică nil dacă nume e nil, altfel numărul; se combină bine cu ??: nume?.count ?? 0;
  • despachetare cu if let nume { ... } sau guard let, ca să lucrezi cu valoarea sigură;
  • ! (nume!.count), doar dacă știi sigur că valoarea există.

Apare des la proprietăți opționale ale structurilor (client.adresa.oras când adresa e opțională), la dict["cheie"].count și la lista.first.uppercased().

De ce apare: cauzele frecvente

1count pe un String?

Greșit
SWIFT
let porecla: String? = "Gigi"
print(porecla.count)
Corect
SWIFT
let porecla: String? = "Gigi"
print(porecla?.count ?? 0)

porecla?.count e Int?; cu ?? 0 obții un Int, chiar și când porecla lipsește.

2Proprietate opțională într-un lanț

Greșit
SWIFT
struct Adresa { let oras: String }
struct Client { let adresa: Adresa? }
let c = Client(adresa: nil)
print(c.adresa.oras)
Corect
SWIFT
struct Adresa { let oras: String }
struct Client { let adresa: Adresa? }
let c = Client(adresa: nil)
print(c.adresa?.oras ?? "fără adresă")

Cu ?. lanțul se oprește la primul nil și întoarce nil, fără să oprească programul.

3Metodă pe primul element

Greșit
SWIFT
let orase = ["cluj", "iași"]
print(orase.first.uppercased())
Corect
SWIFT
let orase = ["cluj", "iași"]
if let primul = orase.first {
    print(primul.uppercased())
}

first e String? (lista poate fi goală). Despachetat cu if let, devine String.

Repară tu

Repară eroarea, direct în pagină

Programul afișează orașul de livrare al unui client care nu are adresă salvată și trebuie să afișeze Livrare: adresă necunoscută, dar compilarea se oprește cu value of optional type 'Adresa?' must be unwrapped to refer to member 'oras' of wrapped base type 'Adresa'. Repară accesul cu optional chaining și ??.

Codul care dă eroarea
SWIFT
struct Adresa {
    let oras: String
}

struct Client {
    let nume: String
    let adresa: Adresa?
}

let client = Client(nume: "Dan", adresa: nil)
let oras = client.adresa.oras
print("Livrare: \(oras)")
După reparație, programul afișează
Livrare: adresă necunoscută
Indiciu

client.adresa?.oras dă String?; completează cu ?? și textul de rezervă.

Alte forme ale mesajului

  • error: value of optional type 'Adresa?' must be unwrapped to refer to member 'oras' of wrapped base type 'Adresa'
  • error: value of optional type 'String?' must be unwrapped to refer to member 'uppercased' of wrapped base type 'String'

Cum o eviți pe viitor

  • Folosește ?. când vrei doar să treci mai departe de un nil și ?? când ai nevoie de o valoare concretă la final.
  • Despachetează cu guard let la începutul funcției valorile fără de care nu poți continua.
  • Gândește-te dacă proprietatea chiar trebuie să fie opțională; dacă există mereu, declar-o fără ?.
  • Nu adăuga ! doar ca să scapi de eroare: mută problema de la compilare la rulare.

Întrebări frecvente

Ce tip are nume?.count?

Int?. Optional chaining păstrează caracterul opțional al rezultatului, chiar dacă count e un Int obișnuit. De aceea se combină de obicei cu ??.

De ce compilatorul îmi propune să pun !?

Pentru că e o reparație posibilă, nu neapărat cea bună. Cu ! programul se oprește dacă valoarea e nil; prefera ?., ?? sau if let.

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.