[[nodiscard]]用于提示编译器函数返回值不应被忽略,若忽略则发出警告,防止关键信息如错误码、资源状态等被遗漏,提升代码安全性。
![c++中的[[nodiscard]]属性有什么用_c++防止函数返回值被忽略](https://img.php.cn/upload/article/001/431/639/176490726752329.png)
[[nodiscard]] 是 C++17 引入的一个属性,用于提示编译器:某个函数的返回值不应该被忽略。如果调用者调用了被标记为 [[nodiscard]] 的函数却未使用其返回值,编译器会发出警告(或错误,取决于编译选项)。
作用:防止重要返回值被意外忽略
很多函数的返回值包含关键信息,比如是否操作成功、是否有错误发生、返回了什么状态等。如果不小心忽略了这些返回值,可能导致逻辑错误或资源泄漏。
通过使用 [[nodiscard]],可以提醒开发者必须处理这个返回值,提高代码安全性。
基本用法
在函数声明前加上 [[nodiscard]]:
立即学习“C++免费学习笔记(深入)”;
[[nodiscard]] int compute_value();
int main() {
compute_value(); // 警告!返回值被忽略
return 0;
}
编译时会看到类似这样的警告:
warning: ignoring return value of ‘int compute_value()’, declared with attribute nodiscard常见应用场景
- 错误码或状态返回:如文件打开失败、网络请求出错等
- 资源获取结果:如内存分配、锁的获取(try_lock)
- 工厂函数:返回新对象但可能需要手动释放
-
STL 中的应用:C++ 标准库中许多函数已使用该属性,例如
std::optional::value()、std::future::get()
自定义类型上使用 [[nodiscard]]
也可以用于类或结构体,表示该类型的函数返回不应被忽略:
[[nodiscard]] struct Result {
bool success;
std::string msg;
};
Result do_something();
此时任何返回 Result 类型的函数都会触发检查。
如何正确处理 [[nodiscard]] 函数
如果确实不需要返回值,应显式丢弃,表明是故意为之:
(void)compute_value(); // 明确表示忽略返回值 auto result = compute_value(); // 接收但不使用(仍可能警告,视编译器而定)
基本上就这些。合理使用 [[nodiscard]] 可以显著减少因忽略返回值导致的 bug,尤其在团队协作和大型项目中非常有用。











