error: 'characters' is unavailable: Please use String directly
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
let s = "abc"
print(s.characters.count)let s = "abc"
print(s.count)String are direct proprietatea count.
2Parcurgerea caracterelor
for c in "ana".characters {
print(c)
}for c in "ana" {
print(c)
}Un String e o secvență de Character, deci îl poți parcurge direct.
3Inversarea unui text
let t = String("abc".characters.reversed())let t = String("abc".reversed())
print(t)Toate metodele de colecție (reversed, filter, map) există direct pe String.
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.
let cuvant = "Swift"
print("Litere: \(cuvant.characters.count)")Litere: 5
Indiciu
count există direct pe String.
Reparația
let cuvant = "Swift"
print("Litere: \(cuvant.count)")De ce merge
Din Swift 4, String e o colecție de caractere, iar characters a fost scoasă în Swift 5. cuvant.count numără direct caracterele textului: S, w, i, f, t, adică 5. Codul nou merge în orice versiune de Swift începând cu 4, deci nu mai trebuie actualizat.
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
error: value of type 'String' has no member 'length' Apelezi o proprietate sau o metodă care nu există pe acel tip (aici length pe String). Folosește numele din Swift (count, uppercased(), append) sau verifică dacă variabila are tipul pe care îl crezi. error: 'subscript(_:)' is unavailable: cannot subscript String with an Int, use a String.Index instead. În Swift nu poți lua un caracter cu s[0]. Folosește s.first, s.last, Array(s)[i] sau un String.Index: s[s.index(s.startIndex, offsetBy: i)]. error: cannot find operator '++' in scope; did you mean '+= 1'? Swift nu are operatorii ++ și --: au fost scoși din limbaj în Swift 3. În loc de i++ scrii i += 1, iar în loc de i-- scrii i -= 1. Î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.
