this 表达式

最终更新: 2024/03/21

为了表示当前函数的 接收者(receiver), 你可以使用 this 表达式:

• 在 类 的成员函数中, this 指向这个类的当前对象实例.
• 在 扩展函数 中, 或 带接收者的函数字面值(function literal) 中, this 代表调用函数时, 在点号左侧传递的 接收者 参数.

如果 this 没有限定符, 那么它指向 包含当前代码的最内层范围. 如果想要指向其他范围内的 this, 需要使用 标签限定符:

带限定符的 this

为了访问更外层范围(比如 类, 或 扩展函数, 或有标签的 带接受者的函数字面值)内的 this, 你可以使用 this@label, 其中的 @label 是一个 标签, 代表你想要访问的 this 所属的范围:

class A { // 隐含的标签 @A
    inner class B { // 隐含的标签 @B
        fun Int.foo() { // 隐含的标签 @foo
            val a = this@A // 指向 A 的 this
            val b = this@B // 指向 B 的 this

            val c = this // 指向 foo() 函数的接受者, 一个 Int 值
            val c1 = this@foo // 指向 foo() 函数的接受者, 一个 Int 值

            val funLit = lambda@ fun String.() {
                val d = this // 指向 funLit 的接受者, 一个 String 值
            }

            val funLit2 = { s: String ->
                // 指向 foo() 函数的接受者, 因为包含当前代码的 Lambda 表达式没有接受者
                val d1 = this
            }
        }
    }
}

隐含的 this

在 this 上调用成员函数时, 可以省略 this. 部分. 如果你有一个非成员函数使用了相同的名称, 那么使用时要小心, 因为某些情况下会调用到非成员函数:

fun main() {
//sampleStart
    fun printLine() { println("Top-level function") }

    class A {
        fun printLine() { println("Member function") }

        fun invokePrintLine(omitThis: Boolean = false)  {
            if (omitThis) printLine()
            else this.printLine()
        }
    }

    A().invokePrintLine() // 这里会调用到成员函数
    A().invokePrintLine(omitThis = true) // 这里会调用到顶级函数
//sampleEnd()
}