Что такое 'scope functions' в Kotlin и когда их следует использовать?

Scope functions позволяют выполнять блок кода в контексте объекта. Основные функции: let, run, with, apply, also. Каждая имеет свои особенности в отношении получателя (invoker, receiver) и возвращаемого значения.

Функция	Получатель	Возвращаемое значение
let	it	Результат последнего выражения в блоке
run	this	Результат последнего выражения в блоке
with	this (не в качестве метода расширения)	Результат последнего выражения в блоке
apply	this	Сам объект настройки
also	it	Сам объект настройки

Использование:

• let: Для выполнения действий над объектом, допускающим значение null, или для введения локальной переменной с более коротким именем.

// Пример: безопасный вызов метода на nullable объекте
val str: String? = "Hello"
str?.let {
    println(it.length) // Выполнится только если str не null
}

• run: Для выполнения блока кода с контекстом объекта (как with), но в качестве метода расширения, или когда требуется вычислить значение в контексте объекта.

// Пример: настройка объекта и получение результата
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applying configurations...")
    joinToString(", ") // Выполняется в контексте List<String>, возвращает String
}
println(configurations)

• with: Для группировки вызовов методов объекта без использования "точки" перед каждым вызовом. Не является методом расширения.

// Пример: группировка вызовов методов одного объекта
val person = Person("Alice", 30)
with(person) {
    println(name) // Доступ к свойствам напрямую
    println(age)
}

• apply: Для настройки объекта. Возвращает сам настроенный объект. Удобно для создания и инициализации объектов в одном выражении.

// Пример: создание и настройка объекта в одном шаге
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Button clicked") }
}

• also: Для выполнения дополнительных действий над объектом, таких как логирование, после некоторой операции. Возвращает сам объект.

// Пример: логирование после выполнения действия
val number = 42
val squared = number.also {
    println("Processing number: $it") // Выполняется над it (number), возвращается number
}.run {
    this * this // Выполняется над this (number), возвращается квадрат
}
println("Squared value: $squared")

Выбор подходящей scope function зависит от того, что требуется сделать с объектом и какое значение должно быть возвращено.