Doxygen：如何使用 EXPAND_AS_DEFINED

Question

我定义了以下宏，并尝试在生成文档时扩展它。

#define GETSET(param) \
bool CYNOVE_Enable##param(postproc_ctx_t ctx, bool enable)  \
{                                                           \
 struct postproc_ctx * c;                                   \
 c = (struct postproc_ctx *)ctx;                            \
 c->do_##param = enable?1:0;                                \
 return TRUE;                                               \
}                                                           \

在 doxygen 中，如果我使用 :

MACRO_EXPANSION = YES

那么当我使用它时宏会被扩展。 但是，如果设置：

MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES
EXPAND_AS_DEFINED = GETSET

宏不会扩展，

因为我认为，其中一个答案是错误的，但评论对于任何冗长的解释都很糟糕，让我补充一下我认为这应该如何工作。

根据 doxygen 文档和此链接，PREDEFINED 和 EXPAND_AS_DEFINED 提供不同的服务目的。我理解 EXPAND_AS_DEFINED 用于选择性地扩展给定的宏“因为它是在源代码中定义的”，因此得名，而 PREDEFINED 在这里赋予 Doxygen 宏的含义。

Answer 1

我认为正如其名称所示，如果这样放置，它只会扩展预定义的宏。您应该

PREDEFINED += GETSET(param)="..."

在 Doxygen 文件中放入类似的内容。

顺便说一句，由于您使用的是 bool：

• enable?1:0 应该只是 enable，bool 没有别的比 C 中的 0 和 1 更好。
• TRUE 应该是 true

Answer 2

我使用提问者的配置选项对其进行了测试，并且宏正常扩展。不知道doxygen更新是否解决了这个问题。

我的版本：在源文件上配置和运行 doxygen 版本 1.9.4 的工具。

tc

#define GETSET(param) \
bool CYNOVE_Enable##param(postproc_ctx_t ctx, bool enable)  \
{                                                           \
 struct postproc_ctx * c;                                   \
 c = (struct postproc_ctx *)ctx;                            \
 c->do_##param = enable?1:0;                                \
 return TRUE;                                               \
}          

GETSET(123)


#define CONST_STRING const char *

CONST_STRING version = "2.xx";

---

另外，你可以使用-d preprocessor来检查宏扩展后的代码是什么样子的。