在Xcode 8 beta和Swift 3中,当您有一个以闭包为参数的方法时,例如：
func foo(bar: (String) -> Void) {
bar("Hello,world")
}
如何记录关闭所需的参数？例如,如果我写道：
/// Calls bar with "Hello,world"
/// - parameter bar: A closure to call
func foo(bar: (String) -> Void) {
bar("Hello,world")
}
那么快速帮助如下所示：
我想知道什么语法将允许我写一些文本来替换“没有描述”.非常感谢！
据我所知,如果您标记它们,您只能记录关闭参数：
/// Calls bar with "Hello,world"
/// - parameter bar: A closure to call
/// - parameter theString: A string to use
func foo(bar: (theString: String) -> Void) {
bar(theString: "Hello,world")
}
这是不太理想的：它强制您在调用闭包时使用参数标签,如果有命名冲突,似乎没有办法区分两者.
编辑：as @Arnaud指出,您可以使用_来阻止在调用闭包时使用参数标签：
/// Calls bar with "Hello,world"
/// - parameter bar: A closure to call
/// - parameter theString: A string to use
func foo(bar: (_ theString: String) -> Void) {
bar("Hello,world")
}
