Kotlin学习6.3：标准库中的高阶函数

Kotlin中的5个通用扩展函数
这些函数都存在Standard.kt文件中，run,with,let,also,apply区别和使用场景：

run()函数

run扩展函数的源码为:

/**
 * Calls the specified function [block] with `this` value as its receiver and returns its result.
 */
@kotlin.internal.InlineOnly
public inline fun <T, R> T.run(block: T.() -> R): R {
    contract {
        callsInPlace(block, InvocationKind.EXACTLY_ONCE)
    }
    return block()
}

它会调用指定的代码块，然后返回结果
查看到会调用contract函数，看一下它在做什么

@ContractsDsl
@InlineOnly
@SinceKotlin("1.2")
internal inline fun contract(builder: ContractBuilder.() -> Unit) { }

DSL(domain specific language)：专门为解决某一特定问题的计算机语言，在Kotlin中特点为：链式调用，大括号嵌套，类似英语句子。主要用到的技术为：扩展函数，lambda，中缀调用，invoke约定。

@ContractsDsl：专用DSL的一部分的指定声明，用于构建函数的契约。
它是由@Retention(AnnotationRetention.BINARY)来进行注解的，注解声明保留有三种分别为：

SOURCE：以源码为保留，不存在于二进制文件中
BINARY：保存在二进制的文件输出中，但是对于反射不可见
RUNTIME：保存在二进制的文件中，是对反射可见的。

@InlineOnly：指定此函数只有在内联中才可以调用。
此函数的接受类型为：ConstractBuilder，查看此类的方法callsInPlace，此函数是告诉编译器所传递的lamaba函数只会在此调用一次。
所有的此高阶函数中的contract一系列方法都是提供信息，帮助编译器分析函数的实际运行情况的。

想要加深对于ContractsDsl的理解，看下面的函数就知道了：

/**
 * Returns `true` if this nullable char sequence is either `null` or empty.
 */
@kotlin.internal.InlineOnly
public inline fun CharSequence?.isNullOrEmpty(): Boolean {
    contract {
        returns(false) implies (this@isNullOrEmpty != null)
    }
    return this == null || this.length == 0
}

如果此函数的返回值为false,那么当前对象就不为null。

这样如果我们接下来再次调用String相关的方法了，就不用添加?了，这就是帮助编译器分析一些判断不出来是否为空的状态。

那么再看回来此函数的具体实现，就是将此lamaba函数包装了一层作用域，然后返回此函数的返回值。

实际使用：由于Kotlin中没有break，continue，都是用return来进行处理的，那么如果我们要处理break的情况，就需要用到此run函数了

run break@ {
    ...
    ...
    //在需要break的地方调用
    return@break
}

with()函数

with函数源码分析为：

/**
 * Calls the specified function [block] with the given [receiver] as its receiver and returns its result.
 */
@kotlin.internal.InlineOnly
public inline fun <T, R> with(receiver: T, block: T.() -> R): R {
    //此函数上面分析过了，同上一样。
    contract {
        callsInPlace(block, InvocationKind.EXACTLY_ONCE)
    }
    return receiver.block()
}

此函数实际干的事情就是，接受了一个参数，然后此对象调用lamaba函数，统一进行处理。
实际使用：一个对象连续调用一系列的方法，使用此函数即可

with(context) {
    //当前的对象为context，直接调用Context所包含的函数即可，不需要使用context.xxx()进行函数调用等
    ...
    ...
}

let()函数

let函数的源码为：

/**
 * Calls the specified function [block] with `this` value as its argument and returns its result.
 */
@kotlin.internal.InlineOnly
public inline fun <T, R> T.let(block: (T) -> R): R {
    //同上
    contract {
        callsInPlace(block, InvocationKind.EXACTLY_ONCE)
    }
    return block(this)
}

此函数同run基本一致，就是run指定了接受类型可以用this来进行处理，而此函数使用it来指代的，遮掩的一个好处就是可以先对此对象进行判断（例如是否为空），然后再调用一系列的函数。
实际情况：

xxx?.let {
    ....
    ....
    ....
}

这样我们可以将一个可空对象进行统一处理，而不必每次都调用?来判断了，增加代码的整洁性和可读性

also()函数

also函数的源码为：

/**
 * Calls the specified function [block] with `this` value as its argument and returns `this` value.
 */
@kotlin.internal.InlineOnly
@SinceKotlin("1.1")
public inline fun <T> T.also(block: (T) -> Unit): T {
    contract {
        callsInPlace(block, InvocationKind.EXACTLY_ONCE)
    }
    block(this)
    return this
}

可以看到同let函数一致，就是返回值是当前对象
实际使用：

...also {
    
}.also {
    
}.also {
    
}

可以用作区分代码块

apply()函数

apply函数源码为：

/**
 * Calls the specified function [block] with `this` value as its receiver and returns `this` value.
 */
@kotlin.internal.InlineOnly
public inline fun <T> T.apply(block: T.() -> Unit): T {
    contract {
        callsInPlace(block, InvocationKind.EXACTLY_ONCE)
    }
    block()
    return this
}

指定接受对象为T类型，返回值为当前对象，可以用作一些对象属性的操作等
实际使用：

val info = Info().apply {
    //对于属性的一些相关操作等
}

总结

在网上找到的一个总结图，可以辅助如何选择。函数使用相差不大，最好在代码中使用相同的方法为主吧。

备注参考文档

https://juejin.im/entry/5a9b2320f265da238f12014d
https://juejin.im/post/5b0048ed518825428a2619ed#comment
https://aisia.moe/2018/03/25/kotlin-contracts-dsl/
https://github.com/JetBrains/kotlin/blob/master/libraries/stdlib/src/kotlin/util/Standard.kt