C/C++：注釋“/*< */”代表什么？

Question

我有一個相當普遍的問題：我最近在 C/C++ 代碼中看到許多#defines 被注釋為“/*< ... */”，例如：

#define ARRSIZE(x)          (sizeof(x)/sizeof(x[0]))        /*< macro to determine the size of an array */

我個人只在定義的評論中看到這一點，谷歌搜索也沒有回答我的問題。 那有什么意義嗎？ 這只是常見的做法還是來自 Doxygen？ 還是有其他原因？

Answer 1

通常， <是 Doxygen 的語法，用於在它們記錄的項目之后出現的文檔。

Doxygen 文檔的“將文檔放在成員之后”部分的示例：

int var; /**< Detailed description after the member */

---

但是，對您提供的示例感到好奇的是，它使用普通注釋塊 ( /* ) 而不是文檔塊（例如， /** ）。 我懷疑這是這個特定示例的作者的疏忽。 或者，作者可能將此約定從文檔塊擴展到所有性質相似的注釋。