C++ 的属性(Attribute)机制自 C++11 起以 [[...]] 语法统一标准化,后续标准不断扩充,它们的作用是向编译器或工具传递额外意图,不改变程序语义,但能影响警告、优化或代码生成。

一、C++11 标准

1.1 [[noreturn]]

这是一个比较特殊的属性,它主要用于优化控制流。

一般来说,如果一个函数被标记为 [[noreturn]],那么就代表这个函数一旦被调用,就永远不会正常返回到调用它的地方继续执行,函数要么抛异常、要么终止程序、要么死循环、要么 longjmp 等。

1
2
3
4
5
6
7
8
// ============================================================
// C++11: [[noreturn]]
// 作用: 声明函数绝不返回调用者 (总是抛出或终止), 帮助编译器优化控制流
// 用法: 置于函数声明之前
// ============================================================
[[noreturn]] void fatal_error(const std::string& msg) {
throw std::runtime_error(msg);
}

注意:一个函数被标记了 [[noreturn]],但是调用后居然返回了,那么这就是一个非常危险的 UB,例如:

1
2
3
[[noreturn]] void bad() {
// 这里什么都没做,函数会正常返回
} // 这是严重的 UB

通常 GCC/Clang 会给出类似于 warning: function declared 'noreturn' should not return 的警告,甚至编译器会严格相信你的承诺而把被 [[noreturn]] 标记的函数后续的代码优化掉:

1
2
3
4
5
6
[[noreturn]] void bad(); // 声明承诺不返回

int f() {
bad();
return 42; // 编译器可能认为这行永远到不了
}

1.2 [[carries_dependency]]

这玩意儿我暂时没搞懂,后面再补吧!

二、C++14 标准

2.1 [[deprecated]]

1
2
3
4
5
6
7
8
9
10
// ============================================================
// C++14: [[deprecated]] / [[deprecated("reason")]]
// 作用: 标记名称或实体已弃用, 使用它时编译器发出警告
// 可用位置: 类, typedef, 变量, 非静态数据成员, 函数, 枚举, 模板特化
// ============================================================
[[deprecated("Use new_api() instead")]]
void old_api() { /* ... */ }

// 类也可以标记弃用
class [[deprecated]] LegacyClass {};

三、C++17 标准

3.1 [[fallthrough]]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// ============================================================
// C++17: [[fallthrough]]
// 作用: 显式声明 switch 中 case 的“穿透”是有意为之, 抑制 -Wimplicit-fallthrough 警告
// 用法: 置于 case 标签前, 作为一条独立语句出现
// ============================================================
void handle(int x) {
switch (x) {
case 1:
// do something
[[fallthrough]]; // 明确告知编译器: 故意落入 case 2
case 2:
// do more
break;
default:
break;
}
}

3.2 [[nodiscard]]

1
2
3
4
5
6
7
8
9
10
11
12
13
// ============================================================
// C++17: [[nodiscard]] / C++20: [[nodiscard("reason")]]
// 作用: 提示函数的返回值不应被忽略, 丢弃返回值时编译器鼓励发出警告
// 可用位置: 函数声明, 枚举声明, 类声明 (按值返回该类/枚举的函数)
// ============================================================
[[nodiscard]] int compute_checksum(); // C++17
[[nodiscard("critical result")]] int validate(); // C++20 可带原因

void caller() {
compute_checksum(); // 编译器可能警告: 返回值被丢弃
// 若确实要丢弃, 传统做法是显式转换为 void:
static_cast<void>(compute_checksum()); // 通常可抑制警告 (但非标准强制)
}

3.3 [[maybe_unused]]

1
2
3
4
5
6
7
8
9
10
// ============================================================
// C++17: [[maybe_unused]] (即用户询问的属性)
// 作用: 抑制“未使用实体”的警告
// 可用位置: 类, typedef, 变量, 非静态数据成员, 函数, 枚举, 枚举项, 参数
// ============================================================
[[maybe_unused]] void maybe_unused_func() {}

void with_unused([[maybe_unused]] int param) {
[[maybe_unused]] int local = 42; // 可能在断言/宏中被条件性使用
}

四、C++20 标准

4.1 [[likely]] / [[unlikely]]

它主要告诉编译器“这个分支大概率会走/不会走”,让它把更可能执行的代码放到更“顺”的位置,减少跳转开销。

这个属性就是个纯优化提示,写错了也不会出错,只会影响编译器优化代码的效果。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
int process(int x) {
if ([[likely]] (x > 0)) {
// 告诉编译器: 这里更常执行, 安排成顺直路径
return x * 2;
} else {
return -x;
}
}

void handle(int code) {
switch (code) {
[[likely]] case 0:
// 0 是最常见的值
break;
[[unlikely]] case 999:
// 错误码, 极少出现
break;
default:
break;
}
}

4.2 [[no_unique_address]]

似懂非懂,对应用场景有点模糊,等我再研究研究!

五、C++23 标准

5.1 [[assume(expr)]]

这玩意儿就好比是——你对着编译器拍着胸脯说:“信我,当前位置这个条件一定是成立的!”。

1
2
3
4
5
6
7
void process(int* p, int n) {
[[assume(p != nullptr)]]; // 承诺 p != nullptr
[[assume(n > 0)]]; // 承诺 n > 0
for (int i = 0; i < n; ++i) {
p[i] = 0; // 编译器知道 p 非空, n 正, 可以做更激进的循环优化
}
}

同样需要注意的是:如果保证是假的,就是未定义行为(UB),算是比较激进的优化属性吧!

还有一个需要注意的是,它与 <cassert> / <assert.h> 头文件提供的宏 assert(expr) 是有很大区别的(表格来自 AI):

assert(expr)[[assume(expr)]]
运行时检查会检查,失败则终止不检查,运行时什么都不做
Release 构建通常被 NDEBUG 移除始终存在于编译期
不成立时程序终止(可观测)未定义行为(不可观测,可能悄悄出错)
目的调试期抓 bug给优化器喂信息