C++ attribute: maybe_unused (since C++17)

抑制未使用实体的警告。

语法

说明

此属性可出现在以下实体的声明中：

• 类 : struct [ [ maybe_unused ] ] S ;
• typedef ，包括通过 别名声明 定义的： [ [ maybe_unused ] ] typedef S * PS ; , using PS [ [ maybe_unused ] ] = S * ;
• 变量，包括 静态数据成员 : [ [ maybe_unused ] ] int x ;
• 非静态数据成员 : union U { [ [ maybe_unused ] ] int n ; } ; ,
• 函数 : [ [ maybe_unused ] ] void f ( ) ;
• 枚举 : enum [ [ maybe_unused ] ] E { } ;
• 枚举项: enum { A [ [ maybe_unused ] ] , B [ [ maybe_unused ] ] = 42 } ;
• 结构化绑定 : [ [ maybe_unused ] ] auto [ a, b ] = std:: make_pair ( 42 , 0.23 ) ;

对于声明为 [ [ maybe_unused ] ] 的实体，如果该实体或其结构化绑定未被使用，编译器将抑制关于未使用实体的警告。

示例

#include <cassert>
[[maybe_unused]] void f([[maybe_unused]] bool thing1,
                        [[maybe_unused]] bool thing2)
{
    [[maybe_unused]] lbl: // 标签“lbl”未被使用，不产生警告
    [[maybe_unused]] bool b = not false and not true;
    assert(b); // 在发布模式下，assert被编译移除，变量“b”未被使用
               // 因其声明为[[maybe_unused]]而不产生警告
} // 参数“thing1”和“thing2”未被使用，不产生警告
int main() {}

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参考文献

参见