C 属性: maybe_unused (自 C23 起)
来自 cppreference.com
抑制对未使用实体的警告。
内容 |
[编辑] 语法
[[ maybe_unused ]] [[ __maybe_unused__ ]] |
|||||||||
[编辑] 说明
此属性可以出现在以下实体的声明中
- 结构体/联合体: struct [[maybe_unused]] S;,
- typedef 名称: [[maybe_unused]] typedef S* PS;,
- 对象: [[maybe_unused]] int x;,
- 结构体/联合体成员: union U { [[maybe_unused]] int n; };,
- 函数: [[maybe_unused]] void f(void);,
- 枚举: enum [[maybe_unused]] E {};,
- 枚举成员: enum { A [[maybe_unused]], B [[maybe_unused]] = 42 };.
如果编译器对未使用实体发出警告,则会抑制对任何声明为 maybe_unused
的实体的警告。
[编辑] 示例
运行此代码
#include <assert.h> [[maybe_unused]] void f([[maybe_unused]] _Bool cond1, [[maybe_unused]] _Bool cond2) { [[maybe_unused]] _Bool b = cond1 && cond2; assert(b); // in release mode, assert is compiled out, and b is unused // no warning because it is declared [[maybe_unused]] } // parameters cond1 and cond2 are not used, no warning int main(void) { f(1, 1); }
[编辑] 另请参阅
C++ 文档 适用于 maybe_unused
|