在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")
- }