c++中的[[nodiscard]]属性有什么用_c++防止函数返回值被忽略

[[nodiscard]]用于提示编译器函数返回值不应被忽略,若忽略则发出警告,防止关键信息如错误码、资源状态等被遗漏,提升代码安全性。

[[nodiscard]] 是 C++17 引入的一个属性,用于提示编译器:某个函数的返回值不应该被忽略。如果调用者调用了被标记为 [[nodiscard]] 的函数却未使用其返回值,编译器会发出警告(或错误,取决于编译选项)。

作用:防止重要返回值被意外忽略

很多函数的返回值包含关键信息,比如是否操作成功、是否有错误发生、返回了什么状态等。如果不小心忽略了这些返回值,可能导致逻辑错误或资源泄漏。

通过使用 [[nodiscard]],可以提醒开发者必须处理这个返回值,提高代码安全性。

基本用法

在函数声明前加上 [[nodiscard]]

[[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,尤其在团队协作和大型项目中非常有用。