Argumenty domyślne i nazwane

Wartości domyślne parametrów

Parametrowi można nadać wartość domyślną – zapisujemy ją po znaku = w nagłówku funkcji. Jeśli przy wywołaniu pominiesz ten argument, funkcja użyje wartości domyślnej.

fun przywitaj(imie: String, powitanie: String = "Cześć") {
    println("$powitanie, $imie!")
}

Tutaj powitanie ma domyślnie wartość "Cześć". Parametr imie domyślnej nie ma, więc trzeba go zawsze podać.

Pomijanie argumentów przy wywołaniu

Dzięki wartości domyślnej tę samą funkcję możesz wywołać krócej lub pełniej – zależnie od potrzeb:

przywitaj("Anna")              // Cześć, Anna!   (użyto domyślnego "Cześć")
przywitaj("Anna", "Witaj")     // Witaj, Anna!   (podano własne powitanie)

Argumenty nazwane

Przy wywołaniu możesz podać nazwę parametru, do którego trafia wartość: nazwa = wartość. To czyni wywołanie czytelniejszym i pozwala ustawiać argumenty w dowolnej kolejności.

przywitaj(imie = "Anna")
przywitaj(imie = "Anna", powitanie = "Hej")

// gdy nazwiemy argumenty, kolejność nie ma znaczenia:
przywitaj(powitanie = "Hej", imie = "Anna")

Pomijanie środkowych argumentów

Argumenty nazwane i domyślne grają w parze. Gdy funkcja ma kilka parametrów domyślnych, a chcesz ustawić tylko jeden z dalszych – nazwij go, a resztę zostaw domyślną.

fun rysuj(znak: Char = '*', szerokosc: Int = 10, wysokosc: Int = 1) {
    for (w in 1..wysokosc) {
        for (s in 1..szerokosc) print(znak)
        println()
    }
}

rysuj()                       // 1 wiersz z 10 gwiazdek
rysuj(wysokosc = 3)           // pomijamy znak i szerokość, ustawiamy tylko wysokość
rysuj(znak = '#', wysokosc = 2)  // szerokość zostaje domyślna (10)

Mniej przeciążeń

W wielu językach, żeby umożliwić różne zestawy argumentów, pisze się kilka funkcji o tej samej nazwie (tzw. przeciążenia). W Kotlinie zwykle nie trzeba – jedna funkcja z wartościami domyślnymi zastępuje cały zestaw.

fun loguj(tekst: String) {
    loguj(tekst, "INFO")
}
fun loguj(tekst: String,
          poziom: String) {
    println("[$poziom] $tekst")
}

fun loguj(
    tekst: String,
    poziom: String = "INFO"
) {
    println("[$poziom] $tekst")
}
// loguj("Start")
// loguj("Błąd", "ERROR")

Efekt jest ten sam, a kodu mniej – i w jednym miejscu. To jedno z tych miejsc, gdzie Kotlin oszczędza sporo pisania.

Zasady i kolejność

• Parametry z wartościami domyślnymi zwykle umieszczamy na końcu listy parametrów.
• W wywołaniu argumenty pozycyjne (bez nazwy) podajemy przed nazwanymi.
• Argumenty nazwane mogą być w dowolnej kolejności względem siebie.
• Aby pominąć argument ze środka, kolejne musisz nazwać.

fun opis(imie: String, wiek: Int, miasto: String = "-") { /* ... */ }

opis("Anna", 18)                       // OK – pozycyjnie, miasto domyślne
opis("Anna", wiek = 18, miasto = "Lębork")  // OK – pozycyjny, potem nazwane

Częste błędy

❌ Błąd 1: pominięcie środkowego bez nazwy

fun rysuj(znak: Char = '*',
          wysokosc: Int = 1) {}
rysuj(3)
// 3 trafia do znak, nie do
// wysokosc -> błąd typu

fun rysuj(znak: Char = '*',
          wysokosc: Int = 1) {}
rysuj(wysokosc = 3)

❌ Błąd 2: literówka w nazwie argumentu

przywitaj(imię = "Anna")
// Błąd! parametr nazywa się
// imie, nie imię

przywitaj(imie = "Anna")

❌ Błąd 3: parametr wymagany po domyślnym

fun f(a: Int = 0, b: Int) {}
f(5)
// 5 trafia do a, a b zostaje
// bez wartości -> błąd

fun f(b: Int, a: Int = 0) {}
f(5)
// b = 5, a = 0

❌ Błąd 4: pozycyjny po nazwanym

opis(imie = "Anna", 18)
// ryzykowne – pozycyjny
// po nazwanym bywa błędem

opis("Anna", wiek = 18)

Podsumowanie

• Parametr może mieć wartość domyślną: fun f(x: Int = 0) – wtedy argument można pominąć.
• Wartości domyślne dobieraj tak, by pokrywały najczęstszy przypadek.
• Argumenty nazwane (f(x = 5)) poprawiają czytelność i pozwalają na dowolną kolejność.
• Aby pominąć argument ze środka listy, kolejne trzeba nazwać.
• Jedna funkcja z domyślnymi zastępuje wiele przeciążeń (kilku wersji tej samej funkcji).
• Zasady: domyślne zwykle na końcu; w wywołaniu pozycyjne przed nazwanymi.

Zadania do wykonania

Zadania wykonaj w Kotlin Playground (play.kotlinlang.org).