[[nodiscard]]用于提示编译器函数返回值不应被忽略，若调用者未使用返回值则触发警告，可防止忽略错误状态或资源泄漏等问题。

[[nodiscard]] 是 c++17 引入的一个属性，用来提示编译器：一个函数的返回值不应该被忽略。如果调用者调用了带有 [[nodiscard]] 的函数却未使用其返回值，编译器会发出警告。

防止忽略重要的返回值

很多函数返回状态码、错误信息或新创建的对象，忽略这些返回值可能导致逻辑错误或资源泄漏。[[nodiscard]] 帮助开发者避免这类问题。

例如：

• 一个函数返回操作是否成功（bool），若不检查可能让错误被掩盖。
• 一个工厂函数返回新对象的指针或句柄，若不接收可能造成内存泄漏。

基本用法示例

给函数加上 [[nodiscard]] 属性：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

代码示例：

[[nodiscard]] bool saveToFile(const std::string& filename) {     // 模拟保存操作     return true; // 成功 } <p>// 调用但忽略返回值 → 触发警告 saveToFile("data.txt"); // 编译器警告：忽略 [[nodiscard]] 函数的返回值 </font>

此时编译器（如 GCC、Clang、MSVC）会提示类似：

立即学习“C++免费学习笔记（深入）”；

warning: ignoring return value of function declared with ‘nodiscard’ Attribute

可应用于类和枚举

除了函数，也可以用于类型定义。表示从该类型构造的临时对象不应被丢弃。

例子：

[[nodiscard]] class Result { public:     void log() const { /* 记录结果 */ } }; <p>Result compute() { return Result{}; }</p><p>compute(); // 警告：忽略了 [[nodiscard]] 类型的临时对象 </font>

实际应用场景

• 系统调用或 API 接口：如 write()、open() 返回状态，必须检查。
• 并发编程：启动线程返回 future 或句柄，需保留以便后续获取结果。
• 自定义容器或智能指针工厂函数：防止忘记接收新对象。

基本上就这些。合理使用 [[nodiscard]] 能提升代码健壮性，让潜在错误更早暴露。虽然不是强制阻止，但配合编译器警告能有效减少疏忽。