Что такое scope functions в Kotlin (let, run, apply, also, with) и когда использовать каждую?

Обзор scope functions

Все пять функций принимают лямбду и выполняют её в контексте объекта. Различия — в двух осях: как объект виден внутри лямбды (this или it) и что возвращается (результат лямбды или сам объект).

let — трансформация и null-safe цепочки

val name: String? = "Alice"
val length = name?.let { it.length }   // Int? = 5

// Трансформация значения
val upper = "hello".let { it.uppercase() }  // HELLO

run — вычисление с контекстом this

val result = StringBuilder().run {
    append("Hello")
    append(", World")
    toString()          // возвращается из run
}
println(result)  // Hello, World

apply — конфигурация объекта (Builder-pattern)

data class Config(var host: String = "", var port: Int = 0)

val cfg = Config().apply {
    host = "localhost"   // this — Config
    port = 8080
}
// cfg.host == "localhost", cfg.port == 8080

also — side-effect без изменения объекта

val list = mutableListOf(1, 2, 3)
    .also { println("Before: $it") }  // логирование
    .also { it.add(4) }               // мутация через it
println(list)  // [1, 2, 3, 4]

with — операции над объектом без extension

val stats = with(listOf(1, 2, 3, 4)) {
    "min=${min()}, max=${max()}, sum=${sum()}"
}
println(stats)  // min=1, max=4, sum=10

Практические правила выбора

• let — null-check + трансформация: obj?.let { transform(it) }
• apply — конфигурация нового объекта (возврат самого объекта удобен в builder-цепочках)
• also — логирование, assertions или другие side-effect без изменения цепочки
• run — замена нескольких строк в блоке с общим контекстом this
• with — когда объект уже есть в переменной и нужно несколько операций без повторного указания имени

Подводные камни

• Вложенные scope functions с одним и тем же именем it теряют читаемость — всегда переименовывайте: let { user -> user.name.let { name -> … } }
• apply возвращает объект, а не результат лямбды — если забыть, можно получить неожиданный тип.
• with не является extension: нельзя использовать в цепочке через точку.
• Чрезмерное использование создаёт «лесенку» из отступов, которая сложнее читается, чем прямой код.
• В apply ссылки на this могут случайно захватить внешний this класса, а не объект — нужна осторожность внутри методов класса.
• Возврат Unit из let технически возможен, но это антипаттерн — используйте also.
• run без объекта-получателя — просто блок кода: легко перепутать две перегрузки.

• Объяснять «scope functions» только как синтаксис и не описывать поведение runtime/compiler.
• Игнорировать важный риск: Цепочки scope functions быстро становятся нечитаемыми, если скрывают имя receiver-а и смешивают mutation с вычислением.
• Давать пример без edge case: отмены, null, recomposition, platform boundary или ошибки.

• Формулирует суть темы «scope functions» своими словами и связывает ее с кодом.
• Называет механизм: Выбор функции должен отражать намерение: apply для конфигурации объекта, also для side effect, let для nullable chaining или преобразования.
• Видит production-последствие: Цепочки scope functions быстро становятся нечитаемыми, если скрывают имя receiver-а и смешивают mutation с вычислением.