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

如果从 被丢弃值表达式 中调用声明为 nodiscard 的函数，或调用返回以值形式声明为 nodiscard 的枚举或类的函数（转换为 void 的情况除外），编译器将建议发出警告。

语法

说明

出现在函数声明、枚举声明或类声明中。

如果，从一个 被丢弃值表达式 而非强制转换为 void 的表达式出发，

• 调用声明为 nodiscard 的函数，或
• 调用以值返回声明为 nodiscard 的枚举或类的函数，或
• 通过 显式类型转换 或 static_cast 调用声明为 nodiscard 的构造函数，或
• 通过 显式类型转换 或 static_cast 初始化声明为 nodiscard 的枚举或类类型的对象

鼓励编译器发出警告。

示例

struct [[nodiscard]] error_info { /*...*/ };
error_info enable_missile_safety_mode() { /*...*/ return {}; }
void launch_missiles() { /*...*/ }
void test_missiles()
{
    enable_missile_safety_mode(); // 编译器可能对丢弃 nodiscard 值发出警告
    launch_missiles();
}
error_info& foo() { static error_info e; /*...*/ return e; }
void f1() { foo(); } // 非按值返回 nodiscard 类型，无警告
// nodiscard( 字符串字面量 ) (C++20 起):
[[nodiscard("PURE FUN")]] int strategic_value(int x, int y) { return x ^ y; }
int main()
{
    strategic_value(4, 2); // 编译器可能对丢弃 nodiscard 值发出警告
    auto z = strategic_value(0, 0); // 正常：返回值未被丢弃
    return z;
}

game.cpp:5:4: warning: ignoring return value of function declared with ⮠
 'nodiscard' attribute
game.cpp:17:5: warning: ignoring return value of function declared with ⮠
 'nodiscard' attribute: PURE FUN

缺陷报告

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

参考文献

另请参阅