c++ - 如何将非成员函数与 Doxygen 中的类相关联？

Question

我确信有一些方法可以使用 \defgroup、\addgroup 和 \@{ \@} 标签来做到这一点，但是经过几个小时的试验和（显然）错误，我问 SO.....

我有：

class C {
public:
    void foo () const;
};

我有一些辅助非成员函数，它们确实是 C 接口的一部分，但不在类中：

std::string
format (const C& c, const std::string &fmt);

我希望格式函数与类函数出现在同一页面上。那是不可能的吗？我能做的最好的就是一个“模块”页面，它将 C 列为一个类（带有指向 C 注释的超链接，并将格式设置为函数？

Answer 1

\relates（或 \memberof）似乎是你要找的。

Answer 2

在该组中创建一个组并在您的类之外分配函数将起作用，但在类文档本身中，除非您使用诸如@seeor之类的命令，否则您将无法获得对您的函数的引用@sa。老实说，因为一个函数需要一个记录的参数并不意味着这个函数自动成为库的一部分，但是您可以使用@defgroup和将类和函数链接在一起@addgroup。