error: escaping closure captures mutating 'self' parameter
Într-o metodă mutating a unui struct, un closure păstrat pentru mai târziu modifică self. Un struct nu poate fi modificat prin referință după ce metoda s-a terminat: transformă tipul în class, sau întoarce valorile noi în loc să le modifici din closure.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o metodă mutating, self se comportă ca un parametru inout: e valid doar cât rulează metoda. Un closure escaping (întors, salvat într-o proprietate, dat unui Task sau unui callback de rețea) poate rula după ce metoda s-a terminat, când nu mai există un self pe care să-l modifice. De aceea Swift interzice ca un astfel de closure să capteze self dintr-o metodă mutating.
Apare des în iOS când un view model e scris ca struct și un callback (incarca { date in self.lista = date }) încearcă să actualizeze starea.
Reparațiile tipice:
- fă tipul
class(tip referință): closure-ul ține o referință la același obiect, iar modificarea se vede peste tot. Ai grijă la cicluri de referințe ([weak self]); - dacă rămâi la
struct, closure-ul întoarce valoarea, iar codul care deține structura o atribuie.
De ce apare: cauzele frecvente
1Struct care întoarce un closure ce se modifică pe sine
struct Contor {
var valoare = 0
mutating func handler() -> () -> Void {
return { self.valoare += 1 }
}
}final class Contor {
var valoare = 0
func handler() -> () -> Void {
return { self.valoare += 1 }
}
}O clasă e referință: closure-ul modifică același obiect și după ce metoda s-a terminat.
2View model struct cu callback asincron
struct Ecran {
var titlu = ""
mutating func incarca(_ cerere: (@escaping (String) -> Void) -> Void) {
cerere { t in self.titlu = t }
}
}final class Ecran {
var titlu = ""
func incarca(_ cerere: (@escaping (String) -> Void) -> Void) {
cerere { [weak self] t in self?.titlu = t }
}
}Starea modificată din callback-uri stă într-o clasă; [weak self] evită ținerea ecranului în viață fără rost.
Repară eroarea, direct în pagină
Contor numără apăsările pe un buton: metoda handler() întoarce closure-ul apelat la fiecare apăsare. După trei apăsări, programul trebuie să afișeze Apasari: 3, dar compilarea se oprește cu escaping closure captures mutating 'self' parameter. Transformă Contor într-o clasă.
struct Contor {
var valoare = 0
mutating func handler() -> () -> Void {
return { self.valoare += 1 }
}
}
var c = Contor()
let apasa = c.handler()
apasa()
apasa()
apasa()
print("Apasari: \(c.valoare)")Apasari: 3
Indiciu
Scrie final class Contor, scoate mutating din metodă și creează obiectul cu let.
Reparația
final class Contor {
var valoare = 0
func handler() -> () -> Void {
return { self.valoare += 1 }
}
}
let c = Contor()
let apasa = c.handler()
apasa()
apasa()
apasa()
print("Apasari: \(c.valoare)")De ce merge
Într-un struct, self dintr-o metodă mutating există doar cât rulează metoda, deci un closure întors nu are ce modifica mai târziu. Ca class, Contor e un tip referință: closure-ul ține o referință la același obiect c, iar fiecare apel apasa() îi crește valoarea. Metodele claselor nu au nevoie de mutating.
Cum o eviți pe viitor
- Tipurile care își schimbă starea din callback-uri, timere sau task-uri să fie
class(în SwiftUI:ObservableObjectsau@Observable). - Păstrează
structpentru date (modele) care se copiază și se modifică sincron. - Dacă un closure trebuie doar să calculeze ceva, fă-l să întoarcă rezultatul în loc să modifice
self.
Întrebări frecvente
De ce în clasă merge, iar în struct nu?
Un struct e o valoare: o modificare din closure ar schimba o copie despre care nimeni nu știe. O clasă e o referință: toți cei care au referința văd aceeași modificare.
Trebuie să pun [weak self] peste tot?
Nu. E nevoie doar când obiectul ține el însuși closure-ul (direct sau indirect), ceea ce ar crea un ciclu de referințe. Pentru un closure folosit o dată și eliberat, o captură normală e în regulă.
Erori înrudite
error: escaping closure captures 'inout' parameter 'valoare' Un closure care e păstrat pentru mai târziu (@escaping, întors din funcție, salvat într-o proprietate) folosește un parametru inout. Un inout trăiește doar cât rulează funcția: folosește un obiect (class) ca stare comună sau întoarce valoarea nouă. error: reference to property 'valoare' in closure requires explicit use of 'self' to make capture semantics explicit Într-un closure escaping dintr-o clasă folosești o proprietate fără self. Swift cere să scrii self.valoare (sau [self] / [weak self] în lista de captură), ca să fie vizibil că closure-ul ține obiectul în viață. error: 'mutating' is not valid on instance methods in classes Ai pus mutating pe o metodă dintr-o clasă. mutating există doar pentru struct și enum; metodele unei clase pot modifica proprietățile var fără el. Șterge cuvântul mutating. Î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.
