Kotlin - 作用域函数（apply、also、run、with、let）

一、作用域函数

1.1 标准库中的作用域函数

在 Standard.kt 标准库中提供了一些便捷的内置高阶函数，可以帮助我们写出更简洁高效的代码。这些函数都是在一个对象上执行一个代码块，形成一个临时作用域可以访问该对象而无需其名称，不同的是这个对象在代码块中如何使用以及整个表达式的返回值是什么。由于是 inline 内联函数，优化了调用函数出入栈的性能开销。

参数	T.()	即 this，直接使用调用者对象 public 的类成员（配置自身）。
	T	即 it，主要是将调用者对象当作参数使用（额外做事），也可以使用调用者对象 public 的类成员。
返回值	T	即返回调用者对象本身，可基于原始对象进行链式调用。
	R	即返回Lambda最后一行的值（如果不是一个具体值就是返回Unit），可基于新值进行链式调用。

	说明	使用场景
apply	public inline fun <T> T.apply(block: T.() -> Unit): T  调用该对象的类成员，返回该对象。	最后还是返回该对象，一系列调用该对象的类成员，因此是对该对象进行配置。
also	public inline fun <T> T.also(block: (T) -> Unit): T  将该对象当做参数使用，返回该对象。	最后还是返回该对象，一系列将该对象当做参数传参使用（也可以调用类成员），因此是插入副作用（进行附加操作）。
let	public inline fun <T, R> T.let(block: (T) -> R): R 将该对象当做参数使用，返回Lambda的值。	①计算出新值或不需要返回值，主要是一系列将该对象当作参数传参使用（也可以调用类成员）。 ②对可空类型对象的多次调用做统一的非空判断。
with	public inline fun <T, R> with(receiver: T, block: T.() -> R): R 调用该对象的类成员，返回Lambda的值。不是扩展函数。	效果和 run 一样，由于不是扩展函数，需要传入已有对象后使用。
run	public inline fun <T, R> T.run(block: T.() -> R): R 调用该对象的类成员，返回Lambda的值。	计算出新值或不需要返回值，一系列调用该对象的类成员。
	public inline fun <R> run(block: () -> R): R 执行若干代码，返回Lambda的值。不是扩展函数。	计算出新值或不需要返回值，聚合一系列代码调用方便阅读。

1.1.1 apply

一系列调用类成员。

val student = Student()
//未使用（每次都要使用变量名调用成员）
student.id = 123
student.name = "张三"
student.study()
student.rest()
//使用后（聚合调用方便阅读，直接调用类成员）
student.apply {
    id = 123456
    name = "李四"
    study()
    rest()
}

1.1.2 also

一系列传参使用，也可以调用类成员。

val student = Student()
//未使用(每次都要用实例名调用，针对该对象的一系列操作挤在一起)
student.setname("张三")
growingUp(student.age)
student.study()
setLeader(student)
//使用后（聚合调用方便阅读，主要是传参使用，也可以调用类成员）
student.also { 
    growingUp(it.age)
    setLeader(it)
    it.setname("张三")
    it.study() 
}

1.1.3 let

聚合调用。

val student = Student()
//未使用(每次都要用实例名调用)
student.setname("张三")
growingUp(student.age)
student.study()
setLeader(student)
//使用后（聚合调用便于阅读）
student.let { 
    it.setname("张三")
    it.study() 
    growingUp(it.age)
    setLeader(it)
}

统一非空判断。 

//未使用(每次都要使用安全调用符)
student?.setName("张三")
student?.setAge(18)
student?.study()
//使用后（只需要使用一次安全调用符）
student?.let {
    it.setName("张三")
    it.setAge(18)
    it.study()
}

提供为空默认值。

val str: String? = null
val length = ser?.let {
    it.length
} ?: 3

 1.1.4 with

效果同 run，不是扩展函数，需要传入对象后使用。

with(recyclerView) {
    layoutManager = LinearLayoutManager(context, RecyclerView.HORIZONTAL, false)
    adapter = mAdapter
}

val student = Student("张三", 18)
val str = with(student) {
    "名字=$name， 年龄=$age"    //调用student类成员并返回新值
}
print(str)    //打印：名字=张三，年龄=18

1.1.5 run

一系列调用类成员。

val str = Student("张三", 18).run {
    "名字=$name， 年龄=$age"    //调用student类成员并返回一个String
}

聚合一段代码调用

num?.let {
  println("The number is $it")
} ?: run {
  println("The number is null")
}

run {
    println("1")
    println("1")
}

1.2 自定义作用域函数

在 Compose 中对于作用域的应用特别多。详见

二、其他标准库函数 

2.1 repeat

原理：将 action 函数执行 times 次。第一次的索引为0。

public inline fun repeat(times: Int, action: (Int) -> Unit) {     contract { callsInPlace(action) }     for (index in 0 until times) {         action(index)     } }

repeat(6) {
    print("A$it,")    //打印：A0,A1,A2,A3,A4,A5,
}

2.2 takeIf 

说明：lambda 返回 true 则返回调用者对象，否则返回 null。

场景：判断是否满足条件，再决定是否赋值或者执行操作。和 if 相似，作用于实例上避免了临时变量赋值的麻烦。

public inline fun <T> T.takeIf(predicate: (T) -> Boolean): T? {     contract {         callsInPlace(predicate, InvocationKind.EXACTLY_ONCE)     }     return if (predicate(this)) this else null }

val num: Int = 3
println(num.takeIf { it > 5 }.toString())   //打印：null
val str = "hello"
println(str.takeIf { it.length > 5 } ?: "default")    //打印：default

2.3 takeUnless 

原理：功能和 takeIf 相反，predicate 返回 false 则返回调用者对象，否则返回 null。

public inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T? {     contract {         callsInPlace(predicate, InvocationKind.EXACTLY_ONCE)     }     return if (!predicate(this)) this else null }

val num: Int = 3
println(num.takeUnless { it > 5 }.toString())   //打印：5

2.4 TODO 

用来标记待办，会抛异常，可以指定异常原因。(这个不是 //TODO)

public inline fun TODO(): Nothing = throw NotImplementedError()

public inline fun TODO(reason: String): Nothing = throw NotImplementedError("An operation is not implemented: $reason")