0

0

c++的[[nodiscard]]属性有什么用? (强制检查返回值)

冰火之心

冰火之心

发布时间:2026-01-16 12:07:03

|

397人浏览过

|

来源于php中文网

原创

不能直接阻止,但能触发编译器警告;它提示返回值有意义、不应被忽略,是否报错取决于编译器及警告设置。

c++的[[nodiscard]]属性有什么用? (强制检查返回值)

[[nodiscard]] 能阻止调用者忽略返回值吗?

不能直接阻止,但能触发编译器警告(或错误,取决于编译选项)。它只是给编译器一个提示:这个函数/类型/构造函数的返回值“有意义”,不该被丢弃。是否报错,取决于你用的编译器和警告级别设置。

哪些地方可以加 [[nodiscard]]?

支持位置包括:函数声明、枚举定义、类/结构体定义、构造函数(C++20 起)、typedef / alias 声明(C++23)。最常见的是加在函数上。

  • [[nodiscard]] int parse_int(const std::string& s); —— 提示调用者检查解析是否成功
  • [[nodiscard]] std::unique_ptr create_widget(); —— 防止资源泄漏(忘了接管指针)
  • [[nodiscard]] bool try_lock(); —— 忽略锁是否获取成功,容易引发竞态

不加 [[nodiscard]] 会出什么问题?

典型问题是逻辑漏洞难以发现。比如:

std::vector v = {1, 2, 3};
v.push_back(4); // 返回 void,没问题
v.insert(v.begin(), 5); // 返回 iterator,但没人用 —— 暂时无害
auto res = std::binary_search(v.begin(), v.end(), 7); // 返回 bool,但写成 std::binary_search(...);就丢了结果

更危险的是:

立即学习C++免费学习笔记(深入)”;

快剪辑
快剪辑

国内⼀体化视频⽣产平台

下载
  • std::fopen("data.txt", "r") 忽略返回值 → nullptr 指针后续解引用崩溃
  • std::fclose(fp) 忽略返回值 → 不知道关闭是否失败,可能丢数据
  • 自定义的 [[nodiscard]] Result parse_json(...) 被静默丢弃 → 错误未处理

怎么让 [[nodiscard]] 真正起作用?

必须配合编译器警告开关:

  • GCC / Clang:-Wnarrowing -Wreturn-type -Wignored-attributes(部分版本需 -Werror=unused-result 或启用 -Wnodiscard
  • MSVC:/wd4834(禁用该警告)或默认已启用 C++17+ 的 [[nodiscard]] 检查
  • CMake 中建议加:set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Werror=unused-result -Wno-unused-parameter")

注意:如果函数返回 void[[nodiscard]] 会被忽略;如果返回值是字面量(如 42)或临时对象且没绑定到引用,某些编译器也可能不警告。

最容易被忽略的是:它不检查“语义上是否该用”,只检查“语法上是否写了”。比如 (void)foo();foo(); 在有重载且某重载返回 void 时,也可能绕过检查。别把它当成银弹,而是配合代码审查和单元测试一起用。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

fclose函数的用法
fclose函数的用法

fclose是一个C语言和C++中的标准库函数,用于关闭一个已经打开的文件,是文件操作中非常重要的一个函数,用于将文件流与底层文件系统分离,释放相关的资源。更多关于fclose函数的相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

326

2023.11.30

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

523

2023.09.20

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

196

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

187

2025.07.04

typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

107

2023.09.26

c语言typedef的用法
c语言typedef的用法

c语言typedef的用法有定义基本类型别名、定义结构体别名、定义指针类型别名、定义枚举类型别名、定义数组类型别名等。本专题为大家提供typedef相关的文章、下载、课程内容,供大家免费下载体验。

96

2023.09.26

typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

107

2023.09.26

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

3

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号