【Kotlin】run , let, apply, also, let

https://developer.android.com/codelabs/java-to-kotlin#0

https://kotlinlang.org/docs/scope-functions.html

• 對不可為 null 的物件執行 lambda：let
• 在局部範圍內引入表達式作為變數：let
• 物件配置：apply
• 物件配置和計算結果：run
• 在需要表達式的地方運行語句：非擴展run
• 附加效果：also
• 將物件的函數呼叫進行分組：with

差異

• 他們引用上下文物件的方式。
• 他們的返回值。

在傳遞給作用域函數的 lambda 中，上下文物件可透過短引用而不是其實際名稱來取得。
每個作用域函數使用兩種方式之一來引用上下文物件：
作為 lambda接收器( this) 或作為 lambda 參數 ( it)。
兩者都提供相同的功能，因此我們針對不同的用例描述了每種方法的優缺點，並提供了使用建議。

fun main() {
    val str = "Hello"
    // this
    str.run {
        println("The string's length: $length")
        //println("The string's length: ${this.length}") // does the same
    }

    // it
    str.let {
        println("The string's length is ${it.length}")
    }
}

this

run、with、 並透過關鍵字apply引用上下文物件作為 lambda接收器this。因此，在它們的 lambda 中，物件就像在普通類別函數中一樣可用。

val adam = Person("Adam")
  .apply {
    age = 20 // same as this.age = 20 
    city = "London" 
  } 
println(adam)

it

然而，當調用對象的函數或屬性時，你無法像使用 this 一樣隱式地獲取對象。因此，當對象主要用作函數調用中的參數時，通過 it 訪問上下文對象更好。如果在代碼塊中使用多個變量，使用 it 也是更好的選擇。

fun getRandomInt(): Int {
    return Random.nextInt(100).also {
        writeToLog("getRandomInt() generated value $it")
    }
}

val i = getRandomInt()
println(i)

// INFO: getRandomInt() generated value 78
// 78

fun getRandomInt(): Int {
    return Random.nextInt(100).also { value ->
        writeToLog("getRandomInt() generated value $value")
    }
}

val i = getRandomInt()
println(i)

// INFO: getRandomInt() generated value 4
// 4