Kotlin 常用标准函数

let函数

函数定义

public inline fun T.let(block: (T) -> R): R = block(this)

功能:调用某对象的let函数,则该对象为函数的参数。在函数块内可以通过 it 指代该对象。返回值为函数块的最后一行或指定return表达式。

用法示例

fun testLet(): Int {
    "string".let {
        println(it)
        val tst = it.plus(" - hhh")
        //plus("hh")    it不可省略
        println(tst)
        return 1
    }
}
 
//输出
//string
//string - hhh

run函数

(1)用法一

函数定义

public inline fun T.run(block: T.() -> R): R = block()

功能:调用run函数时,在函数内用this代表当前引用对象,并且调用其方法时,this可省略。返回值是语句块的最后一行,若最后一行语句无返回值,则整个run语句块也无返回值

示例一

fun testRun() {
    val list = mutableListOf("a", "b", "c")
    var what = 0

    what = list.run{
        this.add("d")
        add("e")
        size
    }

    println(list)
    println(what)
}
 
//输出
//[a,b,c,d,e]
//5

(2)用法二

函数定义

public inline fun run(block: () -> R): R = block()

功能:调用run函数块。返回值为函数块最后一行,或者指定return表达式。

示例二

val a = run {
    println("test")
    666
}
println(a)
 
//输出
//test
//666

注:即使不执行println(a) ,run函数块里的println("test") 也会执行。

apply函数

函数定义

public inline fun T.apply(block: T.() -> Unit): T { block(); return this }

功能:调用某对象的apply函数,在函数范围内,可以this(this可以省略)访问该对象的任意public方法和属性,最后函数返回值为该对象

用法示例

fun testApply() {
    val textView = TextView(this).apply {
        text = "hhhhh"
        this.setSingleLine()
        ellipsize = TextUtils.TruncateAt.END
    }
}

with函数

函数定义

public inline fun with(receiver: T, block: T.() -> R): R = receiver.block()

功能:上面说的函数都是扩展函数的形式,with函数并不是扩展函数,所以调用的形式也有所不同,它是将某对象作为函数的参数,在函数块内可以通过 this 指代该对象,访问参数对象的方法或属性时this可以省略。返回值为函数块的最后一行或指定return表达式。

用法示例

val list = mutableListOf("a", "b")

val what = with(list) {
    this.add("c")
    add("d")
    size
}
println(list)
println(what)
 
//输出
//[a,b,c,d]
//4

also函数

函数定义

public inline fun T.also(block: (T) -> Unit): T { block(this); return this }

功能:调用某对象的also函数,则该对象为函数的参数。在函数块内可以通过 it 指代该对象。返回值为该对象自己。

用法示例:

fun testAlso() {
    val list = mutableListOf("a", "b", "c")

    list.also {
        println(it)
        it.add("d")
    }
    println(list)
}

注:在使用this来代指参数对象时需要注意,如果参数对象的方法名和外部的类的方法名重复,而又想在函数内部调用外部的同名方法,可以使用[email protected]()来调用。

takeIf 函数

函数定义

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

功能:

接收一个返回值为Boolean 的lambda 表达式predicate,如果predicate 值为true 则返回调用takeIf 的对象自身,如果predicate 的值为false 则返回null。

用法示例:

class A(val name: String, val age: Int)
fun testTakeIf() {
    val list = arrayListOf()

    val names = list.filterNotNull().takeIf { it.isNotEmpty() }?.map { it.name }?.reduce { acc, s -> acc + "_" + s }    // 1
}

上面注释 1 处 的代码作用就是:先在A 列表中筛选出非空项,再判断列表内还有没有元素,如果有再映射为name 列表,再将name 列表组合成一个以下划线连接的字符串。

takeUnless 函数

函数定义:

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

通过函数的定义可以看出,takeUnless 函数的用法和takeIf 正好相反,当传入的条件predicate 值为false 时返回调用者自身,否则返回null。用法不再举例。

repeat 函数

函数定义:

public inline fun repeat(times: Int, action: (Int) -> Unit) {
    contract { callsInPlace(action) }

    for (index in 0 until times) {
        action(index)
    }
}

功能:

repeat 函数接收两个参数,第一个参数是重复的次数,第二个参数是一个方法,即要重复执行的方法,action 的参数是重复第几次的索引。

用法示例:

fun testRepeat() {
  repeat(5) {
    println("第 $it 次执行方法")
  }
}
// 打印结果:
// 第 0 次执行方法
// 第 1 次执行方法
// 第 2 次执行方法
// 第 3 次执行方法
// 第 4 次执行方法

你可能感兴趣的:(Kotlin 常用标准函数)