Ce sunt 'funcțiile de scop' în Kotlin și când trebuie utilizate?

Funcțiile de scope permit executarea unui bloc de cod în contextul unui obiect. Funcțiile principale sunt: let, run, with, apply, also. Fiecare are propriile caracteristici în ceea ce privește receptorul (invoker, receiver) și valoarea returnată.

Funcție	Receptor	Valoare returnată
let	it	Rezultatul ultimei expresii din bloc
run	this	Rezultatul ultimei expresii din bloc
with	this (nu ca metodă de extensie)	Rezultatul ultimei expresii din bloc
apply	this	Obiectul configurat însuși
also	it	Obiectul configurat însuși

Utilizare:

• let: Pentru a efectua acțiuni asupra unui obiect care poate fi null sau pentru a introduce o variabilă locală cu un nume mai scurt.

// Exemplu: apel sigur al unei metode pe un obiect nullable
val str: String? = "Hello"
str?.let {
    println(it.length) // Se execută doar dacă str nu este null
}

• run: Pentru a executa un bloc de cod cu contextul obiectului (ca with), dar ca metodă de extensie, sau când trebuie calculat o valoare în contextul obiectului.

// Exemplu: configurarea unui obiect și obținerea rezultatului
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Aplicând configurațiile...")
    joinToString(", ") // Executat în contextul List<String>, returnează String
}
println(configurations)

• with: Pentru a grupa apelurile de metode ale unui obiect fără a folosi "punct" înainte de fiecare apel. Nu este o metodă de extensie.

// Exemplu: gruparea apelurilor de metode ale aceluiași obiect
val person = Person("Alice", 30)
with(person) {
    println(name) // Acces direct la proprietăți
    println(age)
}

• apply: Pentru configurarea unui obiect. Returnează obiectul configurat însuși. Este util pentru crearea și inițializarea obiectelor într-o singură expresie.

// Exemplu: crearea și configurarea unui obiect într-un singur pas
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Buton apăsat") }
}

• also: Pentru a efectua acțiuni suplimentare asupra unui obiect, cum ar fi logarea, după o anumită operație. Returnează obiectul însuși.

// Exemplu: logare după efectuarea unei acțiuni
val number = 42
val squared = number.also {
    println("Procesare număr: $it") // Se execută pe it (number), returnează number
}.run {
    this * this // Se execută pe this (number), returnează pătratul
}
println("Valoarea pătratului: $squared")

Alegerea funcției de scope potrivite depinde de ceea ce doriți să faceți cu obiectul și ce valoare trebuie returnată.