Result Builder — что это, синтаксис и применение

Что такое Result Builder?

Result Builder (ранее известный как function builders) — это механизм Swift, позволяющий превращать последовательность выражений, разделённых переносом строки, в единое значение. Он объявляется с помощью атрибута @resultBuilder, применённого к структуре, которая реализует статические методы преобразования.

До появления result builders декларативный синтаксис SwiftUI body был невозможен. Вместо компактного списка view разработчику пришлось бы писать вызовы TupleView вручную. Result Builder автоматически оборачивает каждое выражение, поддерживает ветвление и циклы, скрывая сложность композиции от разработчика.

По данным Swift Evolution SE-0289, принятого в 2022 году, result builder — это развитие идеи function builders (SE-0258, Swift 5.1). Основные изменения: переименование с @_functionBuilder на @resultBuilder и расширение на параметры функций, что позволило использовать билдеры для любых closure-аргументов, а не только для body view.

Используйте result builders, когда нужно предоставить пользователям вашей библиотеки декларативный синтаксис для построения сложных структур — конфигураций, запросов, UI-компонентов — без написания императивного кода сборки.

Как работает Result Builder

Компилятор Swift преобразует каждый блок кода, помеченный @resultBuilder, в последовательность вызовов статических методов билдера. Рассмотрим простейший билдер, который объединяет строки:

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

Использование этого билдера — каждая строка на отдельной строке объединяется через пробел:

@StringBuilder
func greeting() -> String {
    "Hello"
    "World"
    "from"
    "Swift"
}
// Compiler transforms this into:
// StringBuilder.buildBlock("Hello", "World", "from", "Swift")
// Result: "Hello World from Swift"

Компилятор группирует последовательные выражения и передаёт их вариативным параметром в buildBlock. Если между выражениями встречается if, компилятор вызывает buildOptional или buildEither для ветвления. Для циклов for-in вызывается buildArray. Таким образом, обычный Swift-код трансформируется в цепочку вызовов, конструирующих итоговое значение.

Методы билдера: buildBlock, buildOptional, buildEither

Каждый result builder определяет набор статических методов, которые компилятор вызывает при трансформации. Основные методы:

Минимальная реализация требует только buildBlock с variadic параметрами — этого достаточно для блоков без ветвлений. Добавление buildOptional и buildEither включает поддержку условных конструкций, а buildArray — циклов. По данным Swift Documentation (2025), рекомендуется реализовывать все методы для максимальной гибкости DSL.

buildExpression позволяет принимать выражения разных типов и преобразовывать их к единому типу билдера. Например, в @ViewBuilder buildExpression принимает Text, Image, Button и приводит их к общему типу View.

Создание кастомного Result Builder

Рассмотрим создание билдера для построения HTML-строк. Этот DSL позволит писать декларативный HTML прямо в 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()
    }
}

Использование кастомного билдера для генерации 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("Footer")
    }
}
// Result: <div><p>Hello</p><p>World</p><p>Footer</p></div>

По данным статьи «Building Custom Result Builders in Swift» от Swift.org (2025), кастомные билдеры применяются в библиотеках для построения конфигурационных файлов, UI-компонентов, маппинга данных и даже запросов к базе данных — везде, где нужен декларативный синтаксис с поддержкой ветвлений.

@ViewBuilder в SwiftUI

@ViewBuilder — это result builder, встроенный в SwiftUI, который применяется к параметру content большинства контейнерных view: VStack, HStack, ZStack, Group, List и самого свойства body. Он позволяет писать несколько view на отдельных строках без запятых и обёрток.

@ViewBuilder реализует все методы result builder, включая поддержку if-else, switch и for-in. Когда условие выполняется, buildEither(first:) возвращает одну view; когда нет — buildEither(second:) возвращает другую. Обе ветки должны возвращать один тип, но SwiftUI использует AnyView внутри или стирание типа через ConditionalContent.

struct GreetingView: View {
    let isLoggedIn: Bool

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

            if isLoggedIn {
                Text("Welcome back!")
                    .foregroundColor(.green)
            } else {
                Button("Log In") { }
            }
        }
    }
}

Без @ViewBuilder этот же код потребовал бы Group для каждой условной секции или использование AnyView, что ухудшает производительность. @ViewBuilder автоматически выбирает наиболее эффективное представление ConditionalContent или TupleView для каждой комбинации.

Ограничения Result Builder

Первое ограничение — максимальное количество выражений в buildBlock. Стандартная библиотека Swift определяет перегрузки buildBlock для 2–10 выражений. Если в блоке больше 10 выражений, компилятор выдаст ошибку. Решение — группировка через Group или VStack для разбиения на подблоки.

Второе ограничение — отсутствие поддержки переменных и присваиваний внутри билдер-блока. Нельзя объявить let x = 5 внутри @ViewBuilder. Все выражения должны быть выражениями, возвращающими значение типа билдера. Для промежуточных вычислений используйте вычисления вне билдера или buildExpression с поддержкой разных типов.

Третье ограничение — сложность отладки. Ошибки компиляции внутри result builder часто дают запутанные сообщения, особенно при несоответствии типов в ветках if/else. Используйте явные возвращаемые типы и AnyView для отладки, хотя последний снижает производительность. По данным Hacking with Swift (2025), практический совет — начинать с простого билдера без ветвлений и добавлять поддержку условных конструкций постепенно.