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

如果从 弃值表达式 （除强制转换为 void 外）中调用声明为 nodiscard 的函数，或调用通过值返回声明为 nodiscard 的枚举或类的函数，建议编译器发出警告。

语法

说明

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

如果，从 弃值表达式 （除强制转换为 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++ 标准。

参考文献

参见