Mi az a 'scope functions' Kotlinben, és mikor kell őket használni?

A scope függvények lehetővé teszik egy kódrészlet végrehajtását egy objektum kontextusában. A fő függvények: let, run, with, apply, also. Mindegyik saját jellemzőkkel rendelkezik a fogadó (invoker, receiver) és a visszatérő érték tekintetében.

Funkció	Fogadó	Visszatérő érték
let	it	A blokk utolsó kifejezésének eredménye
run	this	A blokk utolsó kifejezésének eredménye
with	this (nem kiterjesztő metódusként)	A blokk utolsó kifejezésének eredménye
apply	this	A konfigurált objektum maga
also	it	A konfigurált objektum maga

Használat:

• let: Olyan műveletek végrehajtására egy objektumon, amely null értékű lehet, vagy egy helyi változó rövidebb névvel való bevezetésére.

// Példa: biztonságos metódushívás nullable objektumon
val str: String? = "Hello"
str?.let {
    println(it.length) // Csak akkor fut le, ha str nem null
}

• run: Egy kódrészlet végrehajtása az objektum kontextusában (mint with), de kiterjesztésként, vagy amikor értéket kell kiszámítani az objektum kontextusában.

// Példa: objektum konfigurálása és eredményének lekérése
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Konfigurációk alkalmazása...")
    joinToString(", ") // List<String> kontextusban fut, String-et ad vissza
}
println(configurations)

• with: Egy objektum metódushívásainak csoportosítása anélkül, hogy minden hívás előtt pontot használnánk. Nem kiterjesztő metódus.

// Példa: ugyanazon objektum metódushívásainak csoportosítása
val person = Person("Alice", 30)
with(person) {
    println(name) // Közvetlen hozzáférés a tulajdonságokhoz
    println(age)
}

• apply: Egy objektum konfigurálására. Visszaadja a konfigurált objektumot. Hasznos az objektumok létrehozásához és inicializálásához egy kifejezésben.

// Példa: objektum létrehozása és konfigurálása egy lépésben
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Gomb megnyomva") }
}

• also: További műveletek végrehajtása egy objektumon, például naplózás, egy művelet után. Visszaadja az objektumot.

// Példa: naplózás egy művelet után
val number = 42
val squared = number.also {
    println("Szám feldolgozása: $it") // fut az it-en (number), visszaadja a number-t
}.run {
    this * this // fut a this-en (number), visszaadja a négyzetet
}
println("Négyzet értéke: $squared")

A megfelelő scope függvény kiválasztása attól függ, mit szeretne tenni az objektummal, és milyen értéket kell visszaadni.