C++ 属性： maybe_unused (C++17 起)

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

语法


`[[maybe_unused]]`

解释

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

class/struct/union：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]] 的实体，如果没有使用这些实体或它们的结构化绑定，那么编译器针对未使用实体发布的警告会被抑制。

对于声明为 [[maybe_unused]] 的标签，如果没有使用这些标签，那么编译器针对未使用标签发布的警告会被抑制。

(C++26 起)

示例

运行此代码

#include <cassert>
 
[[maybe_unused]] void f([[maybe_unused]] bool thing1,
                        [[maybe_unused]] bool thing2)
{
    [[maybe_unused]] lb: // 未使用标签 “lb”，无警告
    [[maybe_unused]] bool b = thing1 && thing2;
    assert(b); // 发行模式中，assert 在编译中被去掉，因而未使用 “b”
               // 无警告，因为它被声明为 [[maybe_unused]]
} // 未使用参数 “thing1” 与 “thing2”，无警告
 
int main() {}

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
CWG 2360	C++17	不能应用 [[maybe_unused]] 到结构化绑定	可以应用

引用

C++23 标准（ISO/IEC 14882:2024）：

9.12.8 Maybe unused attribute [dcl.attr.unused]

C++20 标准（ISO/IEC 14882:2020）：

9.12.7 Maybe unused attribute [dcl.attr.unused]

C++17 标准（ISO/IEC 14882:2017）：

10.6.6 Maybe unused attribute [dcl.attr.unused]

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

assume (C++23)
carries_dependency (C++11)
deprecated (C++14)
fallthrough (C++17)
indeterminate (C++26)
likely (C++20)
maybe_unused (C++17)
nodiscard (C++17)
noreturn (C++11)
no_unique_address (C++20)
optimize_for_synchronized (TM TS)
unlikely (C++20)

C++ 属性： maybe_unused (C++17 起)

语法

解释

示例

缺陷报告

引用

参阅

导航