Android第一行代码——快速入门 Kotlin 编程（3.7 Kotlin课堂：标准函数和静态方法）

目录

3.7        Kotlin课堂：标准函数和静态方法

3.7.1        标准函数 with、run 和 apply

3.7        Kotlin课堂：标准函数和静态方法

        现在我们即将进入本书首次的 Kotlin 课堂，之后的几乎每一章中都会有这样一个环节。虽说目前你已经可以上手 Kotlin 编程了，但我们只是在第 2 章中学习了一些 Kotlin 的基础知识而已，其实还有许多的高级技巧并没有涉猎。因此每章的 Kotlin 课堂里，我都会结合所在章节的内容，拓展出更多Kotlin 的使用技巧，这将会是你提升自己 Kotlin 水平的绝佳机会。

3.7.1        标准函数 with、run 和 apply

        Kotlin 的标准函数指的是 Standard.kt 文件中定义的函数，任何 Kotlin 代码都可以自由地调用所有的标准函数。

        虽说标准函数并不多，但是想要一次性全部学完还是比较吃力的，因此这里我们主要学习几个最常用的标准函数。

        首先在上一章中，我们已经学习了 let 这个标准函数，它的主要作用就是配合 ? . 操作符来进行辅助判空处理，这里就不再赘述了。

下面我们从 with 函数开始学起。with 函数接收两个参数：第一个参数可以是一个任意类型的对象，第二个参数是一个 Lambda 表达式。with 函数会在 Lambda 表达式中提供第一个参数对象的上下文，并使用 Lambda 表达式中的最后一行代码作为返回值返回。示例代码如下：

val result = with(obj) { 
    // 这里是obj的上下文
    "value" // with函数的返回值
} 

        那么这个函数有什么作用呢？它可以在连续调用同一个对象的多个方法时让代码变得更加精 简，下面我们来看一个具体的例子。

        比如有一个水果列表，现在我们想吃完所有水果，并将结果打印出来，就可以这样写：

fun main(){
    val list = listOf("Apple", "Banana", "Orange", "Pear", "Grape")
    val builder = StringBuilder()
    builder.append("Start eating fruits.\n")
    for (fruit in list) {
        builder.append(fruit).append("\n")
    }
    builder.append("Ate all fruits.")
    val result = builder.toString()
    println(result)
}

        这段代码的逻辑很简单，就是使用 StringBuilder 来构建吃水果的字符串，最后将结果打印出 来。如果运行一下上述代码，那么一定会得到如 图3.45 所示的打印结果。

        仔细观察上述代码，你会发现我们连续调用了很多次 builder 对象的方法。其实这个时候就可 以考虑使用 with 函数来让代码变得更加精简，如下所示：

fun main(){

    val list = listOf("Apple", "Banana", "Orange", "Pear", "Grape")
    val result = with(StringBuilder()){
        append("Start eating fruits.\n")
        for (fruit in list){
            append(fruit).append("\n")
        }
        append("Ate all fruits.")
        toString()
    }
    println(result)
}

        这段代码乍一看可能有点迷惑性，其实很好理解。首先我们给 with 函数的第一个参数传入了一 个 StringBuilder 对象，那么接下来整个 Lambda 表达式的上下文就会是这个 StringBuilder 对象。于是我们在 Lambda 表达式中就不用再像刚才那样调用 builder.append() 和builder.toString() 方法了，而是可以直接调用 append() 和 toString() 方法。Lambda 表达式的最后一行代码会作为 with 函数的返回值返回，最终我们将结果打印出来。

        这两段代码的执行结果是一模一样的，但是明显第二段代码的写法更加简洁一些，这就是 with 函数的作用。

        下面我们再来学习另外一个常用的标准函数：run 函数。run 函数的用法和使用场景其实和 with 函数是非常类似的，只是稍微做了一些语法改动而已。首先 run 函数通常不会直接调用， 而是要在某个对象的基础上调用；其次 run 函数只接收一个 Lambda 参数，并且会在 Lambda 表达式中提供调用对象的上下文。其他方面和 with 函数是一样的，包括也会使用 Lambda 表达式中的最后一行代码作为返回值返回。示例代码如下：

val result = obj.run { 
    // 这里是obj的上下文
    "value" // run函数的返回值
} 

        那么现在我们就可以使用 run 函数来修改一下吃水果的这段代码，如下所示：

fun main(){
//    run 写法
    val list = listOf("Apple", "Banana", "Orange", "Pear", "Grape")
    val result = StringBuilder().run {
        append("Start eating fruits.\n")
        for (fruit in list){
            append(fruit).append("\n")
        }
        append("Ate all fruits.")
        toString()
    }
    println(result)
}

        总体来说变化非常小，只是将调用 with 函数并传入 StringBuilder 对象改成了调用 StringBuilder 对象的 run 方法，其他都没有任何区别，这两段代码最终的执行结果是完全相同的。

        最后我们再来学习标准函数中的 apply 函数。apply 函数和 run 函数也是极其类似的，都要在某个对象上调用，并且只接收一个 Lambda 参数，也会在 Lambda 表达式中提供调用对象的上下文，但是apply函数无法指定返回值，而是会自动返回调用对象本身。示例代码如下：

val result = obj.apply { 
    // 这里是obj的上下文
} 
// result == obj 

        那么现在我们再使用 apply 函数来修改一下吃水果的这段代码，如下所示：

fun main(){
//    apply 写法
    val list = listOf("Apple", "Banana", "Orange", "Pear", "Grape")
    val result = StringBuilder().apply {
        append("Start eating fruits.\n")
        for (fruit in list){
            append(fruit).append("\n")
        }
        append("Ate all fruits.")
    }
    println(result.toString())
}

        注意这里的代码变化，由于 apply 函数无法指定返回值，只能返回调用对象本身，因此这里的 result 实际上是一个 StringBuilder 对象，所以我们在最后打印的时候还要再调用它的 toString()方法才行。这段代码的执行结果和前面两段仍然是完全相同的，我就不再重复演示了。

        这样我们就将 Kotlin 中最常用的几个标准函数学完了，你会发现其实 with、run 和 apply 这几个函数的用法和使用场景是非常类似的。在大多数情况下，它们可以相互转换，但你最好还是 要掌握它们之间的区别，以便在编程时能够作出最佳的选择。

        回想一下刚刚在最佳实践环节编写的启动 Activity 的代码：

val intent = Intent(context, SecondActivity::class.java) 
intent.putExtra("param1", "data1") 
intent.putExtra("param2", "data2") 
context.startActivity(intent) 

        这里每传递一个参数就要调用一次 intent.putExtra() 方法，如果要传递 10 个参数，那就得 调用 10 次。对于这种情况，我们就可以使用标准函数来对代码进行精简，如下所示：

val intent = Intent(context,SecondActivity::class.java).apply {
    putExtra("param1","data1")
    putExtra("param2","data1")
}
context.startActivity(intent)

        可以看到，由于Lambda 表达式中的上下文就是Intent 对象，所以我们不再需要调用 intent.putExtra() 方法，而是直接调用 putExtra() 方法就可以了。传递的参数越多，这 种写法的优势也就越明显。 

        好了，关于Kotlin 的标准函数就讲到这里，本书后面的章节中还将会有大量使用标准函数的代码 示例，到时候你会对它们掌握得越来越熟练。

小贴士：

let 函数，它的主要作用就是配合 ? . 操作符来进行辅助判空处理

with 函数接收两个参数：

        第一个参数可以是一个任意类型的对象，

        第二个参数是一个 Lambda 表达式

run 函数通常不会直接调用， 而是要在某个对象的基础上调用；

        其次 run 函数只接收一个 Lambda 参数，

                并且会在 Lambda 表达式中提供调用对象的上下文。

        其他方面和 with 函数是一样的

apply 函数要在某个对象上调用，

                只接收一个 Lambda 参数

                在 Lambda 表达式中提供调用对象的上下文

                自动返回调用对象本身