¿Qué son las 'funciones de alcance' en Kotlin y cuándo se deben usar?

Las funciones de alcance permiten ejecutar un bloque de código en el contexto de un objeto. Las funciones principales son: let, run, with, apply, also. Cada una tiene sus propias características respecto al receptor (invocador, receptor) y al valor de retorno.

Función	Receptor	Valor de retorno
let	it	El resultado de la última expresión en el bloque
run	this	El resultado de la última expresión en el bloque
with	this (no como método de extensión)	El resultado de la última expresión en el bloque
apply	this	El propio objeto configurado
also	it	El propio objeto configurado

Uso:

• let: Para realizar acciones sobre un objeto que puede ser null, o para introducir una variable local con un nombre más corto.

// Ejemplo: llamada segura a un método en un objeto nullable
val str: String? = "Hello"
str?.let {
    println(it.length) // Solo se ejecuta si str no es null
}

• run: Para ejecutar un bloque de código con el contexto del objeto (como with), pero como método de extensión, o cuando se necesita calcular un valor en el contexto del objeto.

// Ejemplo: configuración de un objeto y obtención del resultado
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applying configurations...")
    joinToString(", ") // Se ejecuta en el contexto de List<String>, devuelve String
}
println(configurations)

• with: Para agrupar llamadas a métodos de un objeto sin usar "punto" antes de cada llamada. No es un método de extensión.

// Ejemplo: agrupación de llamadas a métodos de un mismo objeto
val person = Person("Alice", 30)
with(person) {
    println(name) // Acceso directo a las propiedades
    println(age)
}

• apply: Para configurar un objeto. Devuelve el propio objeto configurado. Útil para crear e inicializar objetos en una sola expresión.

// Ejemplo: creación y configuración de un objeto en un solo paso
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Button clicked") }
}

• also: Para realizar acciones adicionales sobre un objeto, como registrar en logs, después de alguna operación. Devuelve el propio objeto.

// Ejemplo: registro en log después de realizar una acción
val number = 42
val squared = number.also {
    println("Processing number: $it") // Se ejecuta sobre it (number), devuelve number
}.run {
    this * this // Se ejecuta sobre this (number), devuelve el cuadrado
}
println("Squared value: $squared")

La elección de la función de alcance adecuada depende de lo que se necesita hacer con el objeto y qué valor debe devolver.