代码之家  ›  专栏  ›  技术社区  ›  Jean-Baptiste Yunès

如何在XCode中记录Swift函数的参数标签和非参数名称?

  •  1
  • Jean-Baptiste Yunès  · 技术社区  · 7 年前

    我知道如何记录函数的参数名称,如:

    /**
     - parameters:
       - param: the parameter
     */
    func myFunc(param: Int) {...}
    

    但我无法记录参数标签(带或不带参数名称):

    /**
     - parameters:
       - label: the label
       - param: the parameter
     */
    func myFunc(label param: Int) {...}
    

    毕竟,记录标签比参数名更重要,因为它是函数调用中使用的内容。

    注意:我在苹果的文档中找不到诀窍,或者我错过了什么?

    1 回复  |  直到 7 年前
        1
  •  1
  •   glyvox    7 年前

    无法直接引用参数标签 在函数的文档中。

    作为一种解决方法,您可以在参数描述中提及标签,如下所示:

    /**
     - parameters:
         - param: (argument label: `label`) the parameter
     */
    func myFunc(label param: Int) {...}
    

    通过使用回勾,它与参数本身很好地融合在一起:

    example function documentation