如何使用Doxygen链接(引用)结构的成员?

玫瑰

我想在显示文本struct.member时“链接”到Doxygen中的结构或结构成员。我的源代码在C中。

例如,假设我在C中具有myStruct类型/结构:

typedef struct
{
    int member1;
    int member2;
} myStruct;

而且我想在显示文本“ myStruct.member1”的同时在我的Doxygen注释中链接/重定向到myStruct的文档。

函数的示例Doxygen注释:
如果myStruct.member1大于5,您将收到错误代码MEMBER_1_NOT_VALID。

单击“ myStruct.member1”会将我重定向到myStruct的文档。

我知道,如果我只有myStruct,我可以说“ \ ref myStruct”,但是不能执行“ \ ref myStruct.member1”。有谁知道如何使文档参考起作用?

任何帮助表示赞赏!谢谢你。

m

我认为问题在于您一起定义了类型和结构。Doxygen的解析器似乎在结构和typedef的混合声明中存在问题。尝试分别定义结构和类型定义:

struct myStruct_s
{ 
    int member1;
    int member2;
};

typedef struct myStruct_s myStruct;

您可以使用结构的标记名引用结构成员,类似于您已经尝试过的:

/**
 * ...
 * You will receive the error code MEMBER_1_NOT_VALID if \ref myStruct_s.member1 
 * is larger than 5.
 * ...
 */

本文收集自互联网,转载请注明来源。

如有侵权,请联系 [email protected] 删除。

编辑于
0

我来说两句

0 条评论
登录 后参与评论

相关文章

Doxygen:如何正确记录限制为80个字符的C结构成员变量?

如何使用指针访问结构成员

为什么结构化绑定不使用`auto&'返回结构成员的引用,而是返回成员本身

如何引用特征并仍使用原始结构?

如何使用引用向量创建结构?

如何使用变量来引用结构的键?

如何使用可变引用克隆结构

如何访问结构的成员

联合或引用作为结构成员

对结构成员的临时绑定引用

用指针算法引用结构成员

如何释放链接结构的结构

如何使用由复合文字定义的结构的成员?

如何使用字符串成员创建Rust结构?

如何在Golang中使用成员函数正确模拟结构?

如何使用image :: ImageBuffer作为成员创建Rust结构?

如何使用函数更改所有结构成员参数?

如何通过引用初始化函数内部的结构数组成员

在结构的并集成员中使用std :: string时,不能引用默认构造函数

如何通过使用父类的引用访问子类的成员?

使用JSON Merge Patch,如何引用子集合的成员?

如何链接到doxygen中的plantuml图?

如果未链接任何使用代码,则对g ++中的静态const成员的未定义引用

结构内的结构:'非法引用非静态成员'错误

使用null结构引用

如何遍历结构成员?

如何获取引用成员的指针?

使用命名空间时如何在结构本身中定义静态结构成员

当您想与结构的成员变量进行比较时,如何在结构的 std::list 上使用 remove_if