Kas ir 'scope funkcijas' Kotlin un kad tās būtu jālieto?

Scope funkcijas ļauj izpildīt koda bloku objektā kontekstā. Galvenās funkcijas: let, run, with, apply, also. Katra ir ar savām īpašībām attiecībā uz saņēmēju (invoker, receiver) un atgriežamo vērtību.

Funkcija	Saņēmējs	Atgriežamā vērtība
let	it	Bloka pēdējās izteiksmes rezultāts
run	this	Bloka pēdējās izteiksmes rezultāts
with	this (kā paplašināšanas metode)	Bloka pēdējās izteiksmes rezultāts
apply	this	Pašs objekts pēc konfigurācijas
also	it	Pašs objekts pēc konfigurācijas

Izmantošana:

• let: Lai veiktu darbības ar objektu, kas var būt null, vai ievadītu vietējo mainīgo ar īsāku nosaukumu.

// Piemērs: droša metode izsaukšana nullable objektā
val str: String? = "Hello"
str?.let {
    println(it.length) // Tiks izpildīts tikai, ja str nav null
}

• run: Lai izpildītu koda bloku ar objekta kontekstu (kā with), bet kā paplašināšanas metodi, vai kad nepieciešams aprēķināt vērtību kontekstā.

// Piemērs: objekta konfigurācija un rezultāta iegūšana
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applying configurations...")
    joinToString(", ") // Darbojas List<String> kontekstā, atgriež String
}
println(configurations)

• with: Lai grupētu objekta metožu izsaukumus bez "punktas" priekš katra.

// Piemērs: objekta metožu izsaukumu grupēšana
val person = Person("Alice", 30)
with(person) {
    println(name) // Tieša piekļuve īpašībām
    println(age)
}

• apply: Lai konfigurētu objektu. Atgriež pašu konfigurēto objektu. Ērti izveidot un inicializēt objektus vienā izteiksmē.

// Piemērs: objekta izveide un konfigurācija vienā solī
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Button clicked") }
}

• also: Lai veiktu papildu darbības ar objektu, piemēram, reģistrāciju, pēc noteiktas operācijas. Atgriež pašu objektu.

// Piemērs: reģistrācija pēc darbības veikšanas
val number = 42
val squared = number.also {
    println("Processing number: $it") // Darbojas uz `it` (number), atgriež number
}.run {
    this * this // Darbojas uz `this` (number), atgriež kvadrātu
}
println("Squared value: $squared")

Pareizas scope funkcijas izvēle ir atkarīga no tā, ko vēlaties darīt ar objektu un kādu vērtību vēlaties saņemt atpakaļ.