...
Eroare Swift · Closure-uri

error: escaping closure captures 'inout' parameter 'valoare'

Pe scurt

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

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

Ce înseamnă

Un parametru inout funcționează după modelul copy-in copy-out: la intrarea în funcție valoarea e copiată, iar la ieșire e scrisă înapoi în variabila de la apel. Cât timp funcția rulează, accesul la variabilă e exclusiv. După ce funcția se termină, legătura nu mai există.

Un closure escaping (întors din funcție, trimis ca @escaping, salvat ca proprietate, pus într-un Task) poate rula mult după ce funcția s-a terminat. Dacă ar captura parametrul inout, ar modifica o copie care nu mai ajunge nicăieri, așa că Swift interzice combinația.

Ce faci în schimb:

  • dacă ai nevoie de stare comună modificată de closure, pune starea într-o clasă (tip referință) și captureaz-o pe ea;
  • dacă closure-ul rulează imediat, fă-l non-escaping (fără @escaping);
  • sau întoarce valoarea calculată, fără inout.

De ce apare: cauzele frecvente

1Closure întors care modifică un inout

Greșit
SWIFT
func contor(_ valoare: inout Int) -> () -> Void {
    return { valoare += 1 }
}
Corect
SWIFT
final class Contor {
    var valoare = 0
}
func incrementare(_ c: Contor) -> () -> Void {
    return { c.valoare += 1 }
}

Obiectul clasei trăiește cât îl ține closure-ul, deci modificările rămân vizibile.

2Callback @escaping care scrie într-un inout

Greșit
SWIFT
func incarca(_ rezultat: inout [String], gata: @escaping () -> Void) {
    let f = { rezultat.append("date"); gata() }
    _ = f
}
Corect
SWIFT
func incarca(gata: @escaping ([String]) -> Void) {
    gata(["date"])
}
incarca { lista in print(lista) }

Rezultatul e trimis prin callback, nu scris într-un inout care nu mai există.

Repară tu

Repară eroarea, direct în pagină

Funcția contor întoarce un closure care crește o valoare la fiecare apel. După două apeluri, programul trebuie să afișeze Total: 2, dar compilarea se oprește cu escaping closure captures 'inout' parameter 'valoare'. Păstrează starea într-o clasă Contor și fă closure-ul să o modifice pe ea.

Codul care dă eroarea
SWIFT
var total = 0

func contor(_ valoare: inout Int) -> () -> Void {
    return { valoare += 1 }
}

let incrementeaza = contor(&total)
incrementeaza()
incrementeaza()
print("Total: \(total)")
După reparație, programul afișează
Total: 2
Indiciu

Scrie final class Contor { var valoare = 0 }, trimite un obiect Contor funcției și modifică c.valoare în closure.

Alte forme ale mesajului

  • error: escaping autoclosure captures 'inout' parameter 'valoare'

Cum o eviți pe viitor

  • Folosește inout doar pentru modificări făcute pe loc, în timpul funcției.
  • Pentru stare care trebuie modificată mai târziu (callback-uri, timere, task-uri), folosește o clasă sau un actor.
  • În cod asincron, preferă să întorci rezultatul (async -> T sau un callback cu valoarea) în loc să scrii într-un parametru.

Întrebări frecvente

De ce closure-urile non-escaping pot folosi inout?

Pentru că rulează garantat înainte ca funcția să se termine, cât timp parametrul inout e încă valid. De exemplu, valori.forEach { total += $0 } într-o funcție cu total inout e permis.

Pot captura o variabilă locală var într-un closure escaping?

Da. O variabilă locală capturată e mutată automat într-o „cutie” pe heap și trăiește cât closure-ul. Restricția e doar pentru parametrii inout.

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.