gpt4 book ai didi

c++ - 我如何@ref 同一方法的不同变体?

转载 作者:太空狗 更新时间:2023-10-29 21:33:03 25 4
gpt4 key购买 nike

我正在为一些 C++ 代码编写 doxygen 注释。我有两个功能:

/** Some existing doxygen comment */
int foo(int x);

/** Another existing doxygen comment */
int foo(
this_signature y1,
is_really_long y2,
and_to_be_honest y3,
i_would y4,
really_rather y5,
avoid_repeating_it y6);

/** This is what I'm writing now */
int foo(double z);

在第二个函数的 doxygen 注释中,@ref 我想引用第二个函数,或者更确切地说是函数的第二个变体。我该怎么做呢?

注意:我特别(不仅仅是机器人)对不会非常冗长的解决方案感兴趣(考虑到第二个函数的长签名)。

最佳答案

它(就像@Scheff 写的那样)可以通过签名来引用。所以像这样:

/** Fie to show reference:
*
* \ref foo(unsigned long)
*
* \ref foo(unsigned long y)
*/
void fie(void);

另见 http://www.doxygen.nl/manual/autolink.html#linkfunc .

关于长签名的评论,要么使用@Scheff 建议的 \anchor 可能性,但在我看来,起初它看起来是一个很好的解决方案,但它不太容易维护(签名变体是在生成文档时检查是否存在,但是 \anchor\ref 中的字符串不存在(您可能需要这样的东西:\ref my_anch "foo(unsigned long y)" 否则 (\ref my_anch) 链接将具有名称 my_anch

关于c++ - 我如何@ref 同一方法的不同变体?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/52927346/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com