c - 是否可以忽略 doxygen 生成的引用图中的 `assert` ionic ？

Question

在我的代码中有一些 assert 调用来确保我的函数正常工作，并对数据结构进行一些不变测试。

有时我在 assert 的参数中使用函数，然后这个函数在该函数的 Doxygens 调用图中。对于一些更大的不变量测试，这确实污染了图表……

如何避免调用图中出现以下代码段中的 list_isSorted？

int list_isElem (List l, Element e) {
  assert(list_isSorted(l));
  {
    if (list_isEmpty(l)) { return 0; }
    switch (compare(e, list_getValue(l))) {
    case -1: return 0;
    case  0: return 1;
    case  1: return list_isElem (list_getTail(l), e);
    default: exit(ERR_UNKNOWN);
    }
  }
}

我已经尝试在 Doxyfile 中设置 PREDEFINED = NDEBUG，但这没有用。

Answer 1

只是跳过断言？

参见 http://www.doxygen.nl/manual/faq.html

“新的和最简单的方法是在开始处添加一个带有\cond 命令的注释 block 和一个带有\endcond 的注释 block ”

用宏自动执行:

#define DAssert(x) /** \cond */ assert(x) /** \endcond */