Cosa sono le 'funzioni di scope' in Kotlin e quando usarle?

Le funzioni di scope consentono di eseguire un blocco di codice nel contesto di un oggetto. Le funzioni principali sono: let, run, with, apply, also. Ognuna ha caratteristiche proprie riguardo al ricevente (invoker, receiver) e al valore di ritorno.

Funzione	Ricevente	Valore di ritorno
let	it	Risultato dell'ultima espressione nel blocco
run	this	Risultato dell'ultima espressione nel blocco
with	this (non come metodo di estensione)	Risultato dell'ultima espressione nel blocco
apply	this	L'oggetto stesso configurato
also	it	L'oggetto stesso configurato

Utilizzo:

• let: Per eseguire azioni su un oggetto che può essere null, o per introdurre una variabile locale con un nome più breve.

// Esempio: chiamata sicura a un metodo su un oggetto nullable
val str: String? = "Hello"
str?.let {
    println(it.length) // Esegue solo se str non è null
}

• run: Per eseguire un blocco di codice con il contesto dell'oggetto (come with), ma come metodo di estensione, o quando si desidera calcolare un valore nel contesto dell'oggetto.

// Esempio: configurazione di un oggetto e ottenimento del risultato
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applicando configurazioni...")
    joinToString(", ") // Eseguito nel contesto di List<String>, restituisce String
}
println(configurations)

• with: Per raggruppare chiamate di metodi di un oggetto senza usare il "punto" davanti a ogni chiamata. Non è un metodo di estensione.

// Esempio: raggruppamento di chiamate di metodi di un oggetto
val person = Person("Alice", 30)
with(person) {
    println(name) // Accesso diretto alle proprietà
    println(age)
}

• apply: Per configurare un oggetto. Restituisce l'oggetto stesso configurato. Utile per creare e inizializzare oggetti in un'unica espressione.

// Esempio: creazione e configurazione di un oggetto in un solo passo
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Bottone cliccato") }
}

• also: Per eseguire azioni aggiuntive sull'oggetto, come il logging, dopo una certa operazione. Restituisce l'oggetto stesso.

// Esempio: logging dopo aver eseguito un'azione
val number = 42
val squared = number.also {
    println("Elaborazione numero: $it") // Esegue su it (number), restituisce number
}.run {
    this * this // Esegue su this (number), restituisce il quadrato
}
println("Valore quadrato: $squared")

La scelta della funzione di scope appropriata dipende da cosa si vuole fare con l'oggetto e quale valore deve essere restituito.