[[nodiscard]] 应用于返回值重要的函数,如错误码、资源句柄或状态对象,防止忽略返回值导致 bug。例如 bool write_data() 标记后,调用时不检查返回值会触发编译警告。可直接用于函数声明,C++20 支持添加说明字符串,也可标记类或枚举类型,使所有返回该类型的函数自动生效。用于工厂函数、资源管理或操作状态返回时,能提升代码健壮性,配合 std::optional 等类型强化“必须处理”语义。
![c++中的[[nodiscard]]属性有什么用_c++17中防止重要函数返回值被忽略的语法](https://img.php.cn/upload/article/001/431/639/176398452623300.png)
[[nodiscard]] 是 C++17 引入的一个属性,用来提示编译器:某个函数的返回值不应该被忽略。如果调用者调用了带有 [[nodiscard]] 的函数但没有使用其返回值,编译器会发出警告。
这个特性主要用于防止程序员无意中忽略关键的返回信息,比如错误码、状态对象或资源句柄,从而避免潜在的 bug。
什么时候该用 [[nodiscard]]
适用于那些返回值具有重要意义的函数,例如:- 返回操作是否成功的布尔值
- 返回错误码或异常状态的枚举类型
- 返回需要手动释放的资源(如智能指针包装的对象)
- 工厂函数返回新创建的对象实例
[[nodiscard]] bool write_data(const std::string& data);如果调用时写成
write_data("hello"); 而不检查返回值,编译器就会警告:“返回值被忽略”。
如何使用 [[nodiscard]]
可以直接加在函数声明前:[[nodiscard]] int calculate_result();也可以带一个字符串说明原因(C++20 起支持):
[[nodiscard("返回的是资源句柄,必须处理")]]
ResourceHandle acquire_resource();
这样编译器警告时可能会显示这条消息,帮助开发者理解为何不能忽略。
它还能用于类和枚举类型,表示用这类类型作为函数返回值时也不应被忽略:
[[nodiscard]] struct OperationResult {
bool success;
int code;
};
所有返回 OperationResult 的函数都会自动带上 [[nodiscard]] 效果。
实际开发中的好处
在大型项目中,很容易不小心写出这样的代码:open_file("config.txt"); // 忘记检查是否打开成功
加上 [[nodiscard]] 后,这类疏忽会在编译阶段就被发现。
尤其适合与现代 C++ 风格配合使用,比如用 std::expected 或 std::optional 返回结果的函数,它们本身就表达了“必须处理”的语义。
基本上就这些。合理使用 [[nodiscard]] 能提升代码健壮性,让接口意图更明确。










