Какие ключевые различия между функциями области видимости `let`, `run`, `with`, `also` и `apply` в Kotlin, и когда следует использовать каждую из них?

Обзор

Kotlin предоставляет пять scope functions (функций области видимости), которые выполняют блок кода над объектом. Они отличаются двумя ключевыми моментами: как ссылаться на объект контекста (this vs it) и какое значение они возвращают.

Функции, возвращающие результат лямбды

• let — ссылается на контекст как it, возвращает результат лямбды. Лучше всего подходит для null-безопасных проверок и преобразований:

• run — ссылается на контекст как this, возвращает результат лямбды. Лучше всего подходит для конфигурации объекта, когда нужен вычисленный результат.
• with — ссылается на контекст как this, возвращает результат лямбды. Лучше всего подходит для вызова нескольких методов на одном объекте:

Функции, возвращающие объект контекста

• apply — ссылается на контекст как this, возвращает сам объект. Лучше всего подходит для инициализации объекта и установки свойств:

• also — ссылается на контекст как it, возвращает сам объект. Лучше всего подходит для побочных эффектов без изменения объекта, например логирования:

Краткая справка

Основное правило

• Используй apply и also, когда нужно вернуть исходный объект — удобно для цепочек вызовов.
• Используй let, run и with, когда нужно вернуть вычисленный результат.
• Предпочитай функции на основе it (let, also), когда передача объекта аргументом в другую функцию улучшает читаемость.