Kas yra 'scope funkcijos' Kotlin ir kada jas naudoti?

Scope funkcijos leidžia vykdyti kodo bloką objekto kontekste. Pagrindinės funkcijos: let, run, with, apply, also. Kiekviena turi savo ypatybes dėl gavėjo (invoker, receiver) ir grąžinamos reikšmės.

Funkcija	Gavėjas	Grąžinama reikšmė
let	it	Paskutinio išraiškos rezultatas bloke
run	this	Paskutinio išraiškos rezultatas bloke
with	this (kaip išplėtimo metodas)	Paskutinio išraiškos rezultatas bloke
apply	this	Pats objektas po konfigūracijos
also	it	Pats objektas po konfigūracijos

Naudojimas:

• let: Norint atlikti veiksmus su objektu, kuris gali būti null, arba įvesti vietinę kintamąjį su trumpesniu pavadinimu.

// Pavyzdys: saugus metodo iškvietimas nullable objekte
val str: String? = "Hello"
str?.let {
    println(it.length) // Bus vykdoma tik jei str nėra null
}

• run: Norint vykdyti kodo bloką su objekto kontekstu (kaip with), bet kaip išplėtimo metodą, arba kai reikia apskaičiuoti reikšmę objekto kontekste.

// Pavyzdys: objekto konfigūracija ir rezultato gavimas
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applying configurations...")
    joinToString(", ") // Vykdoma List<String> kontekste, grąžina String
}
println(configurations)

• with: Norint grupuoti objekto metodų iškvietimus be "taškas" prieš kiekvieną iškvietimą.

// Pavyzdys: objekto metodų iškvietimų grupavimas
val person = Person("Alice", 30)
with(person) {
    println(name) // Tiesioginis prieigos būdas
    println(age)
}

• apply: Skirtas objekto konfigūravimui. Grąžina patį konfigūruotą objektą. Patogu kurti ir inicijuoti objektus vienu išraišku.

// Pavyzdys: objekto kūrimas ir konfigūravimas vienu žingsniu
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Button clicked") }
}

• also: Skirtas papildomoms veikloms atlikti su objektu, pvz., logavimui, po tam tikros operacijos. Grąžina patį objektą.

// Pavyzdys: logavimas po veiksmų atlikimo
val number = 42
val squared = number.also {
    println("Processing number: $it") // Vykdoma ant `it` (number), grąžina number
}.run {
    this * this // Vykdoma ant `this` (number), grąžina kvadratą
}
println("Squared value: $squared")

Tinkamiausios scope funkcijos pasirinkimas priklauso nuo to, ką norite padaryti su objektu ir kokią reikšmę norite gauti.