[TOC] # 作用域函数 Kotlin 标准库包含几个函数，它们的唯一目的是**在对象的上下文中执行代码块**。**当对一个对象调用这样的函数并提供一个 [lambda 表达式](lambdas.html)时，它会形成一个临时作用域。在此作用域中，可以访问该对象而无需其名称**。这些函数称为**作用域函数**。共有以下五种：`let`、`run`、`with`、`apply` 以及 `also`。 这些函数基本上做了同样的事情：**在一个对象上执行一个代码块。不同的是这个对象在块中如何使用，以及整个表达式的结果是什么**。 下面是作用域函数的典型用法 ```kotlin data class Person(var name: String, var age: Int, var city: String) { fun moveTo(newCity: String) { city = newCity } fun incrementAge() { age++ } } fun main() { //sampleStart Person("Alice", 20, "Amsterdam").let { println(it) it.moveTo("London") it.incrementAge() println(it) } //sampleEnd } ``` **如果不使用 `let` 来写这段代码，就必须引入一个新变量，并在每次使用它时重复其名称**。 ```kotlin data class Person(var name: String, var age: Int, var city: String) { fun moveTo(newCity: String) { city = newCity } fun incrementAge() { age++ } } fun main() { //sampleStart val alice = Person("Alice", 20, "Amsterdam") println(alice) alice.moveTo("London") alice.incrementAge() println(alice) //sampleEnd } ``` **作用域函数没有引入任何新的技术，但是它们可以使你的代码更加简洁易读**。 由于作用域函数的相似性质，为你的案例选择正确的函数可能有点棘手。选择主要取决于你的意图和项目中使用的一致性。下面我们将详细描述各种作用域函数及其约定用法之间的区别。 ## 区别 由于作用域函数本质上都非常相似，因此了解它们之间的区别很重要。每个作用域函数之间有两个主要区别： * **引用上下文对象的方式** * **返回值** ### 上下文对象：`this` 还是 `it` **在作用域函数的 lambda 表达式里，上下文对象可以不使用其实际名称而是使用一个更简短的引用来访问**。 每个作用域函数都使用以下两种方式之一来访问上下文对象：**作为 lambda 表达式的[接收者](lambdas.html#带有接收者的函数字面值)（`this`）或者作为 lambda 表达式的参数（`it`）**。两者都提供了同样的功能，因此我们将针对不同的场景描述两者的优缺点，并提供使用建议。 ```kotlin fun main() { val str = "Hello" // this str.run { println("The receiver string length: $length") //println("The receiver string length: ${this.length}") // 和上句效果相同 } // it str.let { println("The receiver string's length is ${it.length}") } } ``` #### this **`run`、`with` 以及 `apply` 通过关键字 `this` 引用上下文对象**。因此，在它们的 lambda 表达式中可以像在普通的类函数中一样访问上下文对象。**在大多数场景，当你访问接收者对象时你可以省略 `this`，来让你的代码更简短**。相对地，如果省略了 `this`，就很难区分接收者对象的成员及外部对象或函数。因此，**对于主要对对象成员进行操作（调用其函数或赋值其属性）的 lambda 表达式，建议将上下文对象作为接收者（`this`）**。 ```kotlin data class Person(var name: String, var age: Int = 0, var city: String = "") fun main() { //sampleStart val adam = Person("Adam").apply { age = 20 // 和 this.age = 20 或者 adam.age = 20 一样 city = "London" } println(adam) //sampleEnd } ``` #### it 反过来，**`let` 及 `also` 将上下文对象作为 lambda 表达式参数。如果没有指定参数名，对象可以用隐式默认名称 `it` 访问**。`it` 比 `this` 简短，带有 `it` 的表达式通常更容易阅读。然而，当调用对象函数或属性时，不能像 `this` 这样隐式地访问对象。因此，**当上下文对象在作用域中主要用作函数调用中的参数时，使用 `it` 作为上下文对象会更好。若在代码块中使用多个变量，则 `it` 也更好**。 ```kotlin import kotlin.random.Random fun writeToLog(message: String) { println("INFO: $message") } fun main() { //sampleStart fun getRandomInt(): Int { return Random.nextInt(100).also { writeToLog("getRandomInt() generated value $it") } } val i = getRandomInt() //sampleEnd } ``` **此外，当将上下文对象作为参数传递时，可以为上下文对象指定在作用域内的自定义名称**。 ```kotlin import kotlin.random.Random fun writeToLog(message: String) { println("INFO: $message") } fun main() { //sampleStart fun getRandomInt(): Int { return Random.nextInt(100).also { value -> writeToLog("getRandomInt() generated value $value") } } val i = getRandomInt() //sampleEnd } ``` ### 返回值 根据返回结果，作用域函数可以分为以下两类： * **`apply` 及 `also` 返回上下文对象**。 * **`let`、`run` 及 `with` 返回 lambda 表达式结果**. 这两个选项使你可以根据在代码中的后续操作来选择适当的函数。 #### 上下文对象 `apply` 及 `also` 的返回值是上下文对象本身。因此，它们可以作为辅助步骤包含在调用链中：你**可以继续在同一个对象上进行链式函数调用**。 ```kotlin fun main() { //sampleStart val numberList = mutableListOf<Double>() numberList.also { println("Populating the list") } .apply { add(2.71) add(3.14) add(1.0) } .also { println("Sorting the list") } .sort() //sampleEnd println(numberList) } ``` 它们**还可以用在返回上下文对象的函数的 return 语句中**。 ```kotlin import kotlin.random.Random fun writeToLog(message: String) { println("INFO: $message") } fun main() { //sampleStart fun getRandomInt(): Int { return Random.nextInt(100).also { writeToLog("getRandomInt() generated value $it") } } val i = getRandomInt() //sampleEnd } ``` #### Lambda 表达式结果 `let`、`run` 及 `with` 返回 lambda 表达式的结果。所以，在**需要使用其结果给一个变量赋值，或者在需要对其结果进行链式操作等情况下，可以使用它们**。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf("one", "two", "three") val countEndsWithE = numbers.run { add("four") add("five") count { it.endsWith("e") } } println("There are $countEndsWithE elements that end with e.") //sampleEnd } ``` 此外，**还可以忽略返回值，仅使用作用域函数为变量创建一个临时作用域**。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf("one", "two", "three") with(numbers) { val firstItem = first() val lastItem = last() println("First item: $firstItem, last item: $lastItem") } //sampleEnd } ``` ## 函数选择 为了帮助你选择合适的作用域函数，我们提供了它们之间的主要区别表。 |函数|对象引用|返回值|是否是扩展函数| |---|---|---|---| |`let`|`it`|Lambda 表达式结果|是| |`run`|`this`|Lambda 表达式结果|是| |`run`|-|Lambda 表达式结果|不是：调用无需上下文对象| |`with`|`this`|Lambda 表达式结果|不是：把上下文对象当做参数| |`apply`|`this`|上下文对象|是| |`also`|`it`|上下文对象|是| 以下是根据预期目的选择作用域函数的简短指南： * 对一个非空（non-null）对象执行 lambda 表达式：`let` * 将表达式作为变量引入为局部作用域中：`let` * 对象配置：`apply` * 对象配置并且计算结果：`run` * 在需要表达式的地方运行语句：非扩展的 `run` * 附加效果：`also` * **一个对象的一组函数调用**：`with` 不同函数的使用场景存在重叠，你可以根据项目或团队中使用的特定约定选择函数。 >[warning]【注意】**尽管作用域函数是使代码更简洁的一种方法，但请避免过度使用它们：这会降低代码的可读性并可能导致错误。避免嵌套作用域函数，同时链式调用它们时要小心：此时很容易对当前上下文对象及 `this` 或 `it` 的值感到困惑**。