...
Eroare Swift · Tipuri și conversii

error: 'characters' is unavailable: Please use String directly

Pe scurt

Ai folosit .characters pe un String, din cod scris pentru Swift 3 sau 4. Din Swift 5, String este el însuși o colecție de caractere: scrie text.count în loc de text.characters.count și for c in text în loc de for c in text.characters.

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

Ce înseamnă

În versiunile vechi de Swift, un String nu era direct o colecție, iar caracterele se obțineau prin proprietatea characters. Din Swift 4, String e o colecție de Character, iar characters a devenit inutilă. În Swift 5 a fost scoasă complet (mesajul vine însoțit de nota „'characters' was obsoleted in Swift 5.0”).

Mesajul îți spune și soluția: „Please use String directly”, adică folosește textul direct. Tot ce făceai cu text.characters merge acum pe text: count, first, reversed(), filter, bucla for.

Apare aproape mereu când copiezi cod din răspunsuri sau tutoriale mai vechi.

De ce apare: cauzele frecvente

1Lungimea unui text

Greșit
SWIFT
let s = "abc"
print(s.characters.count)
Corect
SWIFT
let s = "abc"
print(s.count)

String are direct proprietatea count.

2Parcurgerea caracterelor

Greșit
SWIFT
for c in "ana".characters {
    print(c)
}
Corect
SWIFT
for c in "ana" {
    print(c)
}

Un String e o secvență de Character, deci îl poți parcurge direct.

3Inversarea unui text

Greșit
SWIFT
let t = String("abc".characters.reversed())
Corect
SWIFT
let t = String("abc".reversed())
print(t)

Toate metodele de colecție (reversed, filter, map) există direct pe String.

Repară tu

Repară eroarea, direct în pagină

Codul a fost copiat dintr-un tutorial vechi. Pentru textul Swift, programul trebuie să afișeze Litere: 5, dar compilarea se oprește cu 'characters' is unavailable: Please use String directly. Repară-l pentru Swift 5.

Codul care dă eroarea
SWIFT
let cuvant = "Swift"
print("Litere: \(cuvant.characters.count)")
După reparație, programul afișează
Litere: 5
Indiciu

count există direct pe String.

Cum o eviți pe viitor

  • Verifică data codului pe care îl copiezi: Swift s-a schimbat mult până la versiunea 5.
  • Lucrează direct cu textul ca pe o colecție: text.count, text.first, text.filter { ... }.
  • Când întâlnești un mesaj „is unavailable”, citește și nota de după: de obicei spune cu ce a fost înlocuit membrul.

Întrebări frecvente

Mai există alte vederi asupra unui String?

Da: text.unicodeScalars, text.utf8 și text.utf16 există și acum, pentru cazurile în care ai nevoie de codurile Unicode sau de octeți. Pentru caractere obișnuite folosești textul direct.

De ce s.count poate fi diferit de numărul de octeți?

Pentru că count numără caractere așa cum le vede omul (de exemplu un emoji sau „ș” compus sunt câte un caracter), nu octeți. Pentru octeți folosește s.utf8.count.

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.