Какви са 'scope функции' в Kotlin и кога трябва да ги…

Функциите за обхват позволяват да изпълняват блок от код в контекста на обект. Основните функции: 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 функция зависи от това какво трябва да се направи с обекта и каква стойност трябва да бъде върната.

Какви са 'scope функции' в Kotlin и кога трябва да ги използваме?