命名空间
变体
操作

C 属性: maybe_unused (自 C23 起)

来自 cppreference.com
< c‎ | 语言‎ | 属性

抑制对未使用实体的警告。

内容

[编辑] 语法

[[ 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