Xcode - 为Swift Closure添加自定义文档

Question

问题：

• 在Swift的自定义Xcode 8关闭中添加文档（使用内置功能而非第三方）的正确格式是什么？
• 您是否可以提供 Apple文档链接来参考？
• 如何指定closure parameters？
• 如何指定closure return type？

示例：

struct S1 {

    /// This block is executed after completion
    var completion : (String, Int) -> (Bool)
}

注意：

Xcode 8内置了向自定义代码添加文档的功能。

可以通过执行以下操作之一来完成此操作：

代码

• Command + Option + Click

• 继续关注代码和Editor＆gt; Structure＆gt; Add documentation

Answer 1

参考：

• 有关参考，请参阅Markup Formatting Reference，即＆＃34;格式化快速帮助＆＃34;

解决方法：

如果给定位置不支持这些标记，那么现在唯一可行的解​​决方法就是：

import numba as nb

def f(x):
    return x*x

def call_func(func):  # only take func
    func = nb.njit(func)   # compile func in nopython mode!
    @nb.njit
    def inner(x):
        return func(x)
    return inner  # return the closure

if __name__ == '__main__':
    call_func_with_f = call_func(f)   # compile once
    print(call_func_with_f(5))        # call the compiled version
    print(call_func_with_f(5))        # call the compiled version
    print(call_func_with_f(5))        # call the compiled version
    print(call_func_with_f(5))        # call the compiled version
    print(call_func_with_f(5))        # call the compiled version