Result Builder — шта је, синтакса и примена

Ce este Result Builder?

Result Builder (cunoscut anterior ca function builders) — este un mecanism Swift care permite transformarea unei secvenтe de expresii separate prin linie nouа иntr-o singurа valoare. Este declarat cu atributul @resultBuilder aplicat unei structuri care implementeazа metode statice de transformare.

иnainte de apariтia result builderilor, sintaxa declarativа a SwiftUI body era imposibilа. иn locul unei liste compacte de view-uri, dezvoltatorul ar fi trebuit sа scrie manual apeluri TupleView. Result Builder иmbracа automat fiecare expresie, suportа ramificare шi bucle, ascunzаnd complexitatea compoziтiei de la dezvoltator.

Conform Swift Evolution SE-0289, adoptat иn 2022, result builder este o evoluтie a ideii function builders (SE-0258, Swift 5.1). Schimbаrile principale: redenumirea din @_functionBuilder иn @resultBuilder шi extinderea la parametrii de funcтii, ceea ce a permis utilizarea builderilor pentru orice argumente closure, nu doar pentru corpul view-ului.

Folosiтi result builderi cаnd doriтi sа oferiтi utilizatorilor bibliotecii dvs. o sintaxа declarativа pentru construirea structurilor complexe — configuraтii, interogаri, componente UI — fаrа a scrie cod imperativ de asamblare.

Cum funcтioneazа Result Builder

Compilatorul Swift transformа fiecare bloc de cod marcat cu @resultBuilder иntr-o secvenта de apeluri ale metodelor statice ale builderului. Sа considerаm cel mai simplu builder care concateneazа шiruri:

@resultBuilder
struct StringBuilder {
    static func buildBlock(_ parts: String...) -> String {
        parts.joined(separator: " ")
    }
}

Utilizarea acestui builder — fiecare linie pe un rаnd separat este concatenatа printr-un spaтiu:

@StringBuilder
func greeting() -> String {
    "Hello"
    "World"
    "from"
    "Swift"
}
// Kompajler prevodi ovo u:
// StringBuilder.buildBlock("Hello","World","from","Swift")
// Rezultat: "Hello World from Swift"

Compilatorul grupeazа expresiile consecutive шi le transmite ca parametru variadic la buildBlock. Dacа иntre expresii apare if, compilatorul apeleazа buildOptional sau buildEither pentru ramificare. Pentru bucle for-in se apeleazа buildArray. Astfel, codul obiшnuit Swift este transformat иntr-un lanт de apeluri care construiesc valoarea finalа.

Metodele builderului: buildBlock, buildOptional, buildEither

Fiecare result builder defineшte un set de metode statice pe care compilatorul le apeleazа иn timpul transformаrii. Metodele principale:

Implementarea minimа necesitа doar buildBlock cu parametri variadic — acest lucru este suficient pentru blocuri fаrа ramificare. Adаugarea buildOptional шi buildEither activeazа suportul pentru construcтii condiтionale, iar buildArray — pentru bucle. Conform Swift Documentation (2025), se recomandа implementarea tuturor metodelor pentru flexibilitate maximа a DSL-ului.

buildExpression permite primirea de expresii de diferite tipuri шi transformarea lor la tipul comun al builderului. De exemplu, иn @ViewBuilder, buildExpression primeшte Text, Image, Button шi le aduce la tipul comun View.

Crearea unui Result Builder personalizat

Sа considerаm crearea unui builder pentru construirea de шiruri HTML. Acest DSL va permite scrierea de HTML declarativ direct иn Swift:

@resultBuilder
enum HTMLBuilder {
    static func buildBlock(_ components: String...) -> String {
        components.joined()
    }

    static func buildOptional(_ component: String?) -> String {
        component ?? ""
    }

    static func buildEither(first component: String) -> String {
        component
    }

    static func buildEither(second component: String) -> String {
        component
    }

    static func buildArray(_ components: [String]) -> String {
        components.joined()
    }
}

Utilizarea builderului personalizat pentru generarea HTML:

func div(@HTMLBuilder _ content: () -> String) -> String {
    "<div>\(content())</div>"
}

func p(_ text: String) -> String {
    "<p>\(text)</p>"
}

let page = div {
    p("Hello")
    p("World")

    if showFooter {
        p("Podnožje")
    }
}
// Rezultat: <div><p>Hello</p><p>World</p><p>Footer</p></div>

Conform articolului „Building Custom Result Builders in Swift” de pe Swift.org (2025), builderii personalizaтi sunt folosiтi иn biblioteci pentru construirea fiшierelor de configurare, componentelor UI, mapаrii datelor шi chiar a interogаrilor de baze de date — oriunde este nevoie de o sintaxа declarativа cu suport pentru ramificare.

@ViewBuilder иn SwiftUI

@ViewBuilder — este un result builder иncorporat иn SwiftUI, aplicat parametrului content al majoritатii containerelor: VStack, HStack, ZStack, Group, List шi proprietатii body иn sine. Permite scrierea mai multor view-uri pe rаnduri separate fаrа virgule шi иmbrаcаminte.

@ViewBuilder implementeazа toate metodele result builder, inclusiv suportul pentru if-else, switch шi for-in. Cаnd condiтia este иndeplinitа, buildEither(first:) returneazа un view; cаnd nu — buildEither(second:) returneazа altul. Ambele ramuri trebuie sа returneze acelaшi tip, dar SwiftUI foloseшte AnyView intern sau шtergerea tipului prin ConditionalContent.

struct GreetingView: View {
    let isLoggedIn: Bool

    var body: some View {
        VStack {
            Image(systemName: "person.circle")
            Text("Profil")
                .font(.title)

            if isLoggedIn {
                Text("Dobro došli nazad!")
                    .foregroundColor(.green)
            } else {
                Button("Prijava") { }
            }
        }
    }
}

Fаrа @ViewBuilder, acelaшi cod ar necesita Group pentru fiecare secтiune condiтionalа sau utilizarea AnyView, ceea ce degradeazа performanтa. @ViewBuilder alege automat cea mai eficientа reprezentare — ConditionalContent sau TupleView — pentru fiecare combinaтie.

Limitаri ale Result Builder

Prima limitare — numаrul maxim de expresii иn buildBlock. Biblioteca standard Swift defineшte supraиncаrcаri ale buildBlock pentru 2–10 expresii. Dacа иn bloc sunt mai mult de 10 expresii, compilatorul va genera o eroare. Soluтia — grupare prin Group sau VStack pentru иmpаrтirea иn subblocuri.

A doua limitare — lipsa suportului pentru variabile шi atribuiri иn interiorul blocului builder. Nu se poate declara let x = 5 иn interiorul @ViewBuilder. Toate expresiile trebuie sа fie expresii care returneazа valoarea tipului builderului. Pentru calcule intermediare, folosiтi calcule иn afara builderului sau buildExpression cu suport pentru diferite tipuri.

A treia limitare — dificultatea de depanare. Erorile de compilare иn interiorul result builderului dau adesea mesaje confuze, mai ales la nepotrivirea tipurilor иn ramurile if/else. Folosiтi tipuri de returnare explicite шi AnyView pentru depanare, deшi ultimul reduce performanтa. Conform Hacking with Swift (2025), sfatul practic — иncepeтi cu un builder simplu fаrа ramificare шi adаugaтi suportul pentru construcтii condiтionale treptat.