...
Eroare Swift · Closure-uri

error: '@escaping' only applies to function types

Pe scurt

Ai pus @escaping pe un parametru care nu e o funcție, de exemplu un Int, un String sau un tablou. @escaping marchează doar closure-urile care trăiesc după terminarea funcției. Scoate-l de la parametrii obișnuiți; la closure-urile opționale nu e necesar.

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

Ce înseamnă

@escaping îi spune compilatorului că un closure primit ca parametru poate fi păstrat și apelat după ce funcția s-a terminat (salvat într-o proprietate, trimis unui task asincron). Are sens doar pentru tipuri de funcții, ca () -> Void sau (Int) -> String.

Pe alte tipuri (Int, String, [Int], un struct), atributul nu înseamnă nimic, iar compilatorul se oprește cu acest mesaj. În versiunile mai vechi, mesajul era @escaping attribute only applies to function types.

Un caz înrudit: la un closure opțional, (() -> Void)?, @escaping nu e permis pentru că închiderea e deja considerată escaping, iar mesajul e closure is already escaping in optional type argument.

De ce apare: cauzele frecvente

1@escaping pe un tip obișnuit

Greșit
SWIFT
func f(_ x: @escaping Int) { print(x) }
Corect
SWIFT
func f(_ x: Int) { print(x) }
f(1)

Valorile obișnuite nu au nevoie de atribut.

2Closure opțional

Greșit
SWIFT
func f(_ g: @escaping (() -> Void)?) { g?() }
Corect
SWIFT
func f(_ g: (() -> Void)?) { g?() }
f { print("gata") }

Closure-urile opționale sunt deja escaping, deci atributul nu e permis.

3Atribut pus pe parametrul greșit

Greșit
SWIFT
func incarca(_ id: @escaping Int, gata: () -> Void) { }
Corect
SWIFT
var salvat: (() -> Void)?
func incarca(_ id: Int, gata: @escaping () -> Void) { salvat = gata }
incarca(1) { print("gata") }
salvat?()

@escaping trebuie pus pe closure-ul care e păstrat, nu pe alt parametru.

Repară tu

Repară eroarea, direct în pagină

Funcția programeaza salvează o acțiune pentru mai târziu. Programul trebuie să afișeze Programat la ora 9, apoi Trimit raportul, dar compilarea se oprește cu '@escaping' only applies to function types. Mută atributul pe parametrul potrivit.

Codul care dă eroarea
SWIFT
var actiuni: [() -> Void] = []

func programeaza(ora: @escaping Int, actiune: () -> Void) {
    print("Programat la ora \(ora)")
    actiuni.append(actiune)
}

programeaza(ora: 9) { print("Trimit raportul") }
for a in actiuni { a() }
După reparație, programul afișează
Programat la ora 9
Trimit raportul
Indiciu

Ora e un Int; doar actiunea e o funcție păstrată după terminarea lui programeaza.

Alte forme ale mesajului

  • error: @escaping attribute only applies to function types
  • error: closure is already escaping in optional type argument

Cum o eviți pe viitor

  • Pune @escaping doar înaintea unui tip de funcție: completion: @escaping (Int) -> Void.
  • Adaugă-l doar când compilatorul îl cere (de exemplu „escaping closure captures non-escaping parameter”).
  • La closure-uri opționale, nu-l scrie deloc.
  • Citește tipul parametrului înainte de atribut: trebuie să conțină ->.

Întrebări frecvente

Când am nevoie de @escaping?

Când closure-ul primit e salvat într-o proprietate sau într-o variabilă din afara funcției, ori e apelat mai târziu, de exemplu după o operație asincronă.

De ce un closure opțional e deja escaping?

Pentru că e învelit într-un Optional, care e un tip valoare obișnuit, iar compilatorul nu poate garanta că nu e păstrat. Swift îl tratează automat ca escaping.

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.