Czym są 'funkcje zakresu' w Kotlinie i kiedy ich używać?

Funkcje zakresu pozwalają na wykonanie bloku kodu w kontekście obiektu. Główne funkcje to: let, run, with, apply, also. Każda z nich ma własne cechy dotyczące odbiorcy (invoker, receiver) i wartości zwracanej.

Funkcja	Odbiorca	Wartość zwracana
let	it	Wynik ostatniego wyrażenia w bloku
run	this	Wynik ostatniego wyrażenia w bloku
with	this (nie jako metoda rozszerzenia)	Wynik ostatniego wyrażenia w bloku
apply	this	Sam obiekt skonfigurowany
also	it	Sam obiekt skonfigurowany

Użycie:

• let: Do wykonywania działań na obiekcie, który może być null, lub do wprowadzenia lokalnej zmiennej z krótszą nazwą.

// Przykład: bezpieczne wywołanie metody na nullable obiekcie
val str: String? = "Hello"
str?.let {
    println(it.length) // Wykona się tylko jeśli str nie jest null
}

• run: Do wykonania bloku kodu z kontekstem obiektu (jak with), ale jako metoda rozszerzenia, lub gdy trzeba obliczyć wartość w kontekście obiektu.

// Przykład: konfiguracja obiektu i uzyskanie wyniku
val configurations = buildList {
    add("Config 1")
    add("Config 2")
}.run {
    println("Applying configurations...")
    joinToString(", ") // Wykonuje się w kontekście List<String>, zwraca String
}
println(configurations)

• with: Do grupowania wywołań metod obiektu bez użycia "kropki" przed każdym wywołaniem. Nie jest metodą rozszerzenia.

// Przykład: grupowanie wywołań metod tego samego obiektu
val person = Person("Alice", 30)
with(person) {
    println(name) // Bezpośredni dostęp do właściwości
    println(age)
}

• apply: Do konfiguracji obiektu. Zwraca sam obiekt skonfigurowany. Przydatne do tworzenia i inicjalizacji obiektów w jednym wyrażeniu.

// Przykład: tworzenie i konfiguracja obiektu w jednym kroku
val button = Button().apply {
    text = "Click Me"
    onClick = { println("Button clicked") }
}

• also: Do wykonywania dodatkowych działań na obiekcie, takich jak logowanie, po pewnej operacji. Zwraca ten sam obiekt.

// Przykład: logowanie po wykonaniu działania
val number = 42
val squared = number.also {
    println("Processing number: $it") // Wykonuje się na it (number), zwraca number
}.run {
    this * this // Wykonuje się na this (number), zwraca kwadrat
}
println("Wartość kwadratu: $squared")

Wybór odpowiedniej funkcji zakresu zależy od tego, co chcesz zrobić z obiektem i jaką wartość chcesz zwrócić.