kotlin - 应该如何记录 Kotlin 函数类型化？

Question

在 Kotlin v1.1+ 中，有声明类型别名的选项，它为现有类型提供替代名称。这对于函数类型特别有用 - 例如：

typealias OnItemClick = (view: View, position: Int) -> Boolean

并且可以像其他成员一样使用 KDoc 评论记录它们：

/**
 * Type definition for an action to be preformed when a view in the list has been clicked.
 */
typealias OnItemClick = (view: View, position: Int) -> Boolean

但是有记录函数类型的参数和返回类型的特定方法吗？

Kotlin 网站提供了有关记录 Kotlin 代码的信息，但没有提及类型别名。

就像函数本身一样，如果函数类型可以这样记录，那就太好了：

/**
 * @param view       the view that was clicked
 * @param position   the layout position from the ViewHolder (see
                     [ViewHolder.getLayoutPosition])
 * @return whether the click was successful
 */
typealias OnItemClick = (view: View, position: Int) -> Boolean

但在 KDoc 中无法识别这些标签。

那么应该如何记录参数和返回类型呢？

Answer 1

不幸的是，此时 KDoc 中没有特别支持将类型别名的参数和返回值记录为函数类型，因此您只需将它们描述为文档的一部分。我已提交功能请求以添加支持。