Swift Academy · Leçon

Créer des mini-DSL avec les générateurs de résultats

Créez un petit DSL avec @resultBuilder : définissez des fonctions de construction, composez des blocs et prenez en charge les conditions et les boucles pour une construction lisible.

Leçon 1 sur 38 étapes

Créer des mini-DSL avec les générateurs de résultats est une leçon Swift Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 3. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Swift Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Swift Academy comprend 3 leçons au total.

Pourquoi utiliser des créateurs de résultats ?

Objectif : transformez des blocs lisibles en valeurs à l'aide de @resultBuilder. Vous définissez comment les éléments se combinent ; le site d'appel reste propre et déclaratif.

Un petit créateur

Déclarez buildBlock pour joindre les éléments et exposez une API (lines{}) qui renvoie un tableau de chaînes à partir d'un bloc clair.

@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)

Conditions dans les créateurs

Avec buildEither, if/else fonctionne à l'intérieur du bloc. Le créateur décide quelle branche contribue au résultat.

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

Boucles dans les créateurs

buildArray rassemble les résultats des boucles (for/map), afin que les éléments répétés puissent être produits naturellement.

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

Créateur à valeur unique

Les créateurs peuvent produire une valeur unique. Ici, nous joignons les différentes parties en une seule chaîne, tout en utilisant des conditions.

@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."

Conseils de conception

Conseils :

  • Gardez les DSL minimaux et ciblés.
  • Fournissez une seule fonction d'entrée claire, annotée avec votre créateur.
  • Ne prenez en charge que ce dont vous avez besoin : buildBlock, buildEither, buildArray.
  • Documentez les instructions autorisées à l'intérieur du bloc.

Objectif d'un créateur de résultats

Vérification rapide : quel est le principal avantage d'un créateur de résultats ?

Récapitulatif

Récapitulatif : définissez des méthodes @resultBuilder pour combiner les éléments, exposez une petite API d'entrée et composez des blocs lisibles prenant en charge if et for.

Gratuit pour commencer

Apprends Swift avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
122
Leçons
409

Questions Fréquemment Posées

La leçon « Créer des mini-DSL avec les générateurs de résultats » est-elle gratuite ?

Oui — le texte complet de « Créer des mini-DSL avec les générateurs de résultats » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Swift Academy, passe à CoddyKit PRO. Le cours Swift Academy comprend 3 leçons au total.

Qu'est-ce que j'apprendrai dans « Créer des mini-DSL avec les générateurs de résultats » ?

Créez un petit DSL avec @resultBuilder : définissez des fonctions de construction, composez des blocs et prenez en charge les conditions et les boucles pour une construction lisible. Tu pratiques Swift Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Swift Academy ?

Aucune expérience préalable n'est requise. Swift Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 3.

Combien de temps prend la leçon « Créer des mini-DSL avec les générateurs de résultats » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Swift Academy ?

Oui. Chaque leçon Swift Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Créer des mini-DSL avec les générateurs de résultats
  2. API à portée limitée et modèles de lisibilité
  3. Exemples pratiques sans frameworks d’interface utilisateur
← Retour à Swift Academy