记录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在这个例子中.在我的实际用例中,我的监听器中有多个参数.

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

现在,我最终@param在addClickListener方法中用块来描述侦听器的参数,但这会在IDE中产生警告,我想知道是否有更合适的方法来执行此操作.

Answer 1

从Kotlin 1.1开始,没有用于记录用作函数参数的函数类型的参数或返回值的语法.有一个开放的YouTrack问题涉及此问题.