Kotlin 官方参考文档 中文版

 主页   资讯   文章   代码 

type: doc
layout: reference
category: "Syntax"
title: "返回与跳转:break 与 continue"

返回和跳转

Kotlin 有三种结构化跳转表达式:

  • return{: .keyword }。默认从最直接包围它的函数或者匿名函数返回。
  • break{: .keyword }。终止最直接包围它的循环。
  • continue{: .keyword }。继续下一次最直接包围它的循环。

所有这些表达式都可以用作更大表达式的一部分:

val s = person.name ?: return

这些表达式的类型是 Nothing 类型

Break 与 Continue 标签

在 Kotlin 中任何表达式都可以用标签(label{: .keyword })来标记。
标签的格式为标识符后跟 @ 符号,例如:abc@fooBar@都是有效的标签(参见语法)。
要为一个表达式加标签,我们只要在其前加标签即可。

loop@ for (i in 1..100) {
    // ……
}

现在,我们可以用标签限制 break{: .keyword } 或者continue{: .keyword }:

loop@ for (i in 1..100) {
    for (j in 1..100) {
        if (……) break@loop
    }
}

标签限制的 break 跳转到刚好位于该标签指定的循环后面的执行点。
continue{: .keyword } 继续标签指定的循环的下一次迭代。

标签处返回

Kotlin 有函数字面量、局部函数和对象表达式。因此 Kotlin 的函数可以被嵌套。
标签限制的 return{: .keyword } 允许我们从外层函数返回。
最重要的一个用途就是从 lambda 表达式中返回。回想一下我们这么写的时候:

//sampleStart
fun foo() {
    listOf(1, 2, 3, 4, 5).forEach {
        if (it == 3) return // 非局部直接返回到 foo() 的调用者
        print(it)
    }
    println("this point is unreachable")
}
//sampleEnd

fun main() {
    foo()
}

这个 return{: .keyword } 表达式从最直接包围它的函数即 foo 中返回。
(注意,这种非局部的返回只支持传给内联函数的 lambda 表达式。)
如果我们需要从 lambda 表达式中返回,我们必须给它加标签并用以限制 return{: .keyword }。

//sampleStart
fun foo() {
    listOf(1, 2, 3, 4, 5).forEach lit@{
        if (it == 3) return@lit // 局部返回到该 lambda 表达式的调用者,即 forEach 循环
        print(it)
    }
    print(" done with explicit label")
}
//sampleEnd

fun main() {
    foo()
}

现在,它只会从 lambda 表达式中返回。通常情况下使用隐式标签更方便。
该标签与接受该 lambda 的函数同名。

//sampleStart
fun foo() {
    listOf(1, 2, 3, 4, 5).forEach {
        if (it == 3) return@forEach // 局部返回到该 lambda 表达式的调用者,即 forEach 循环
        print(it)
    }
    print(" done with implicit label")
}
//sampleEnd

fun main() {
    foo()
}

或者,我们用一个匿名函数替代 lambda 表达式。
匿名函数内部的 return{: .keyword } 语句将从该匿名函数自身返回

//sampleStart
fun foo() {
    listOf(1, 2, 3, 4, 5).forEach(fun(value: Int) {
        if (value == 3) return  // 局部返回到匿名函数的调用者,即 forEach 循环
        print(value)
    })
    print(" done with anonymous function")
}
//sampleEnd

fun main() {
    foo()
}

请注意,前文三个示例中使用的局部返回类似于在常规循环中使用 continue{: .keyword }。并没有 break{: .keyword } 的直接等价形式,不过可以通过增加另一层嵌套 lambda 表达式并从其中非局部返回来模拟:

//sampleStart
fun foo() {
    run loop@{
        listOf(1, 2, 3, 4, 5).forEach {
            if (it == 3) return@loop // 从传入 run 的 lambda 表达式非局部返回
            print(it)
        }
    }
    print(" done with nested loop")
}
//sampleEnd

fun main() {
    foo()
}

当要返一个回值的时候,解析器优先选用标签限制的 return,即

return@a 1

意为“从标签 @a 返回 1”,而不是“返回一个标签标注的表达式 (@a 1)”。