Swift Academy · Lezione

Creare mini-DSL con i result builder

Crei una piccola DSL usando @resultBuilder : definisca le funzioni del builder, componga i blocchi e supporti condizioni/cicli per una costruzione leggibile.

Lezione 1 di 38 passaggi

Creare mini-DSL con i result builder è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 1 di 3. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 3 lezioni in totale.

Perché usare i result builder?

Obiettivo: trasformare blocchi leggibili in valori usando @resultBuilder. Lei definisce come combinare gli elementi; il punto di chiamata rimane pulito e dichiarativo.

Un builder minimale

Dichiariamo buildBlock per unire gli elementi ed esponiamo un'API (lines{}) che restituisce un array di stringhe a partire da un blocco pulito.

@resultBuilder
struct StringListBuilder {
    static func buildBlock(_ parts: String...) -> [String] { parts }
    // Optional support for conditionals/arrays:
    static func buildEither(first: [String]) -> [String] { first }
    static func buildEither(second: [String]) -> [String] { second }
    static func buildArray(_ components: [[String]]) -> [String] { components.flatMap { $0 } }
}

// DSL entry function using the builder
func lines(@StringListBuilder _ content: () -> [String]) -> [String] {
    content()
}

// Usage: create an array of strings with a block
let list = lines {
    "Hello"
    "Swift"
    "Builders"
}
print(list)

Condizionali nei builder

Con buildEither, if/else funziona all'interno del blocco. Il builder decide quale ramo contribuire.

let showExtra = true
let conditional = lines {
    "Base"
    if showExtra {
        "Extra"
    } else {
        "Hidden"
    }
}
print(conditional)  // ["Base","Extra"]

Cicli nei builder

buildArray raccoglie i risultati dei cicli (for/map), così le parti ripetute possono essere prodotte naturalmente.

let items = ["a","b","c"]
let looped = lines {
    for x in items { x.uppercased() } // contributes ["A","B","C"]
}
print(looped)

Builder a valore singolo

I builder possono produrre un valore singolo. In questo caso uniamo le parti in un'unica stringa, continuando a usare i condizionali.

@resultBuilder
struct TextBuilder {
    static func buildBlock(_ parts: String...) -> String {
        parts.joined(separator: " ")
    }
    static func buildEither(first: String) -> String { first }
    static func buildEither(second: String) -> String { second }
    static func buildArray(_ components: [String]) -> String {
        components.joined(separator: " ")
    }
}

func text(@TextBuilder _ content: () -> String) -> String { content() }

// Compose a small sentence with conditions
let loggedIn = false
let sentence = text {
    "[INFO]"
    "Welcome,"
    if loggedIn { "user!" } else { "guest." }
}
print(sentence) // "[INFO] Welcome, guest."

Suggerimenti di progettazione

Suggerimenti:

  • Mantenga le DSL minime e focalizzate.
  • Fornisca un'unica funzione di ingresso chiara, annotata con il suo builder.
  • Supporti solo ciò che serve: buildBlock, buildEither, buildArray.
  • Documenti quali istruzioni sono consentite all'interno del blocco.

Scopo dei result builder

Verifica rapida: qual è il principale vantaggio di un result builder?

Riepilogo

Riepilogo: definisca i metodi di @resultBuilder per combinare le parti, esponga una piccola API di ingresso e componga blocchi leggibili con il supporto di if/for.

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi
122
Lezioni
409

Domande Frequenti

La lezione «Creare mini-DSL con i result builder» è gratuita?

Sì — il testo completo di «Creare mini-DSL con i result builder» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 3 lezioni in totale.

Cosa imparerò in «Creare mini-DSL con i result builder»?

Crei una piccola DSL usando @resultBuilder : definisca le funzioni del builder, componga i blocchi e supporti condizioni/cicli per una costruzione leggibile. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 3.

Quanto tempo richiede la lezione «Creare mini-DSL con i result builder»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Creare mini-DSL con i result builder
  2. API con ambito e pattern di leggibilità
  3. Esempi pratici senza framework UI
← Torna a Swift Academy