C++ 属性： maybe_unused (C++17 起)
来自cppreference.com
抑制针对未使用实体的警告。
语法
|
|||||||||
解释
此属性可出现在下列实体的声明中：
- 类：
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);
|
(C++26 起) |
对于声明为 [[maybe_unused]] 的实体，如果没有使用这些实体或它们的结构化绑定，那么编译器针对未使用实体发布的警告会被抑制。
|
对于声明为 |
(C++26 起) |
示例
运行此代码
#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++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| 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]
参阅
maybe_unused 的 C 文档
|
