Kotlin: Что означает «return @»?

Question

Я использую RxJava в одном из моих проектов, я преобразовал один из своих классов в Kotlin, используя плагин Android Studio, и на одной из карт flatMap lambda (Func1 in java), промежуточные результаты выглядят следующим образом: @Func1.

Я понятия не имею, что это значит.

something.flatMap(Func1<ArticleCriteria, Observable<Pair<String, String>>> { 
    val isTemporaryClone = it.isATemporaryClone 
    val isTheOriginalToken = it.tokenIsOriginalHere 

    if (isTemporaryClone) { 
     if (!isTheOriginalToken) { 
      return@Func1 paramsError("Token is always original for temp articles") 
     } 

     return@Func1 mJobRunner.doNotRun(DeleteArticleJob.TAG) 
          .doOnNext(deletePersonalActionById(articleId)) 
    } 

    runArticleJobAsync(DeleteArticleJob.TAG, it) 
}) 

Answer 1

В Котлине return@label syntax используется для указания функции из нескольких вложенных, с которой возвращается этот оператор.

Он работает с функциональными литералами (lambdas) и локальными функциями. Немаркированные операторы return возвращаются с ближайшей (то есть самой внутренней), содержащей fun (игнорируя лямбда). Рассмотрим эту функцию:

fun foo(ints: List<Int>) { 
    ints.forEach { 
     if (it == 0) return 
     print(it) 
    } 
} 

^{Здесь return завершит выполнение из foo, а не только лямбда.}

Но если вы хотите, чтобы вернуться из любой другой функции (лямбда или внешнего fun) вы должны указать его в качестве метки на return заявление:

fun foo(ints: List<Int>) { 
    ints.forEach { 
     if (it == 0) return@forEach // implicit label for lambda passed to forEach 
     print(it) 
    } 
} 

fun foo(ints: List<Int>): List<String> { 
    val result = ints.map f@{ 
     if (it == 0) return@f "zero" // return at named label 
     if (it == -1) return emptyList() // return at foo 
     "number $it" // expression returned from lambda 
    } 
    return result 
} 

foo(listOf(1, -1, 1)) // [] 
foo(listOf(1, 0, 1)) // ["number 1", "zero", "number 1"] 

Non-local return (т. Е. Возврат из внешних функций) из лямбда поддерживается только для функций local и inline, потому что если al ambda не встроена (или функция помещена внутри объекта), она не может быть вызвана только внутри закрывающей функции (например, он может быть сохранен в переменной и вызван позже), и нелокальное возвращение в этом случае не имеет смысла.

---

Существует также аналогичный синтаксис для qualified this, который используется для ссылки на приемники внешних областей: this@outer.

Answer 2

return@name для определенности, которые должны применяться закрытие return заявление.

В Котлин вы можете вызвать возврат из вложенного закрытия, чтобы закончить внешнее закрытие. В Java это невозможно.

Обычно вы можете опустить @name.

В вашем примере вы не можете его опустить, потому что Func1 используется внутри другой функции.