vault backup: 2022-09-30 21:33:03

Affected files:
03. Programming/Kotlin/run, let, with, also 和 apply.md

03. Programming/Kotlin/run, let, with, also 和 apply.md

@@ -1,8 +1,8 @@
-run, let, with, also 和 apply 這幾個都是可以搭配object 使用的函數，它們之間的差異不大，主要是讓程式看起來更符合語意。
+`run`, `let`, `with`, `also` 和 `apply` 這幾個都是可以搭配 object 使用的函數，它們之間的差異不大，主要是讓程式看起來更符合語意。
 以下解釋各個的差別。
 
 ## run
-run後面的區塊會**回傳「最後一行」**，所以可以進行「串接」。如下：
+`run` 後面的區塊會**回傳「最後一行」**，所以可以進行「串接」。如下：
 ```kotlin
 run {
     val telephone = Telephone()
@@ -12,16 +12,16 @@ run {
 ```
 
 ## object.run
-object.run跟[[run, let, with, also 和 apply#run]]是一樣的，只是object.run是讓object呼叫的，而且lambda scope中的物件會變成this，如下：
+`object.run` 跟[[run, let, with, also 和 apply#run]]是一樣的，也是**回傳「最後一行」**，只是 `object.run` 是讓 object 呼叫的，而且 lambda scope 中的物件會變成 `this`，`this` 可以省略，但是不可以自訂變數名稱，如下：
 ```kotlin
 val anObject = MyObject()
 anObject.run {
-    this.doSomething()  // this就是anObject
+    this.doSomething()  // this就是anObject，this可以省略
 }
 ```
 
-## with
+## object.with
-`with(T)` 之中的傳入值可以以 `this` (稱作 identifier) 在 scope 中取用，不用打出 `this`也沒關係。雖然， `with` 也會**將最後一行回傳**。但是因為with沒有先判斷物件是否為null，所以scope中還是要用?來判斷是否null，如下：
+`with(T)` 之中的傳入值可以以 `this` (稱作 identifier) 在 scope 中取用，不用打出 `this`也沒關係。雖然， `with` 也會**將最後一行回傳**。但是因為 `with` 沒有先判斷物件是否為 `null`，所以 scope 中還是要用`?`來判斷是否 `null`，如下：
 ```kotlin
 val anObject = makeMyObject()  // anObject有可能是null
 with(anObject) {
@@ -29,8 +29,8 @@ with(anObject) {
 }
 ```
 
-## let
+## object.let
-let的scope裡，物件是it，一樣會**回傳最後一行**。如下：
+`let` 的 scope 裡，物件是 `it`，可以自訂變數名稱，一樣會**回傳最後一行**。如下：
 ```kotlin
 val anObject = makeMyObject()  
 anObject?.let {          // anObject有可能是null，所以要先用?判斷
@@ -38,8 +38,8 @@ anObject?.let {          // anObject有可能是null，所以要先用?判斷
 }
 ```
 
-## also
+## object.also
-also的scope裡，物件是 it，但是不是回傳最後一行，是**回傳自己**（也就是it）。如下：
+`also` 的 scope 裡，物件是 `it`，可以自訂變數名稱，但是不是回傳最後一行，是**回傳自己**（也就是 `it`）。如下：
 ```kotlin
 val anObject = makeMyObject()  
 anObject?.also {       // anObject有可能是null，所以要先用?判斷
@@ -51,15 +51,15 @@ anObject?.also {       // anObject有可能是null，所以要先用?判斷
 }
 ```
 
-## apply
+## object.apply
-apply的scope裡，物件是 this，但是不是回傳最後一行，是**回傳自己**（也就是it）。如下：
+apply的scope裡，物件是 this，不可以自訂變數名稱，但是不是回傳最後一行，是**回傳自己**（也就是it）。如下：
 ```kotlin
 val anObject = makeMyObject()  
-anObject?.also {       // anObject有可能是null，所以要先用?判斷
+anObject?.also {         // anObject有可能是null，所以要先用?判斷
-    it.doSomething()   // it就是anObject，在scope內一定不是null
+    this.doSomething()   // this就是anObject，在scope內一定不是null
 }.also {
-    it.doSomething2()  // it就是anObject
+    this.doSomething2()  // this就是anObject
 }.also {
-    it.doSomething3()  // it就是anObject
+    this.doSomething3()  // this就是anObject
 }
 ```