documentation - 在 Kotlin 中记录函数参数的参数

Question

假设我有一个高阶函数，它注册了某种点击监听器。我可以记录它的用途和传入的 listener 参数:

/**
 * Adds a [listener] that's called when the item is clicked.
 *
 * @param listener The listener to add
 */
fun addClickListener(listener: (count: Int) -> Unit) {
    ...
}

我的问题是，有没有办法记录 listener 的参数？在此示例中，这将是 count。在我的实际用例中，我的监听器中有多个参数。

我注意到，在我使用此功能的文档 View 中，[listener] 文本是可点击的，但它只显示一个关于它的空对话框。有没有办法以某种方式描述那里的参数？

现在，我最终在 addClickListener 方法中使用 @param block 描述了监听器的参数，但这会导致 IDE 中出现警告，我想知道是否有更合适的方法。

Answer 1

从 Kotlin 1.1 开始，没有语法来记录用作函数参数的函数类型的参数或返回值。有一个 open YouTrack issue覆盖这个。