0

0

c++的[[nodiscard]]属性有什么用? (防止返回值被忽略)

冰火之心

冰火之心

发布时间:2026-01-14 10:52:02

|

806人浏览过

|

来源于php中文网

原创

[[nodiscard]]是C++17引入的编译期属性,用于在调用者忽略函数返回值时触发警告;适用于资源获取、状态/错误码、值变换等关键语义函数,需在声明处显式标注,不自动传播,可与[[noreturn]]等属性共存。

c++的[[nodiscard]]属性有什么用? (防止返回值被忽略)

[[nodiscard]] 是 C++17 引入的属性,核心作用就是:**让编译器在调用者忽略函数返回值时发出警告(或错误)**。它不是运行时机制,纯属编译期约束,用来捕获那些“本该检查却忘了检查”的逻辑漏洞。

哪些函数适合加 [[nodiscard]]

不是所有函数都需要——只对「返回值携带关键语义、忽略即可能出错」的函数才真正有意义:

  • 资源获取类函数:std::unique_ptr create_resource()FILE* fopen(...)(忽略返回值意味着没拿到句柄,后续操作全崩)
  • 状态/错误码函数:std::expected parse_int(const std::string&)、自定义的 ErrorCode do_something()(忽略返回值 = 默认假设成功,掩盖失败)
  • 值变换但不就地修改的函数:std::string to_upper(const std::string&)(原字符串不变,新字符串被丢弃 = 白干)
  • 标准库中已广泛使用:如 std::vector::data()std::optional::value_or()std::regex_search()

怎么加?语法和常见写法差异

可以加在函数声明、函数模板、类/结构体、枚举、甚至整个命名空间(C++20)上。最常用的是函数级别:

[[nodiscard]] int find_value(const std::vector& v, int target);

// 也可带说明文字(C++20),提升警告可读性 [[nodiscard("error code must be checked")]] ErrorCode write_file(const char* path);

// 类型别名也能标记(C++20) using Result = [[nodiscard]] std::expected;

注意:[[nodiscard]] 不会自动传播到重载或特化版本,每个声明需单独标注;成员函数同样适用,包括 const 成员函数。

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

忽略返回值时会发生什么?编译器行为与实际效果

效果完全取决于编译器实现和警告级别设置:

MewXAI
MewXAI

一站式AI绘画平台,支持AI视频、AI头像、AI壁纸、AI艺术字、可控AI绘画等功能

下载
  • Clang/GCC 在 -Wall-Wreturn-type 下默认触发 [-Wunused-result] 警告
  • MSVC 对应警告是 C4834(“discarding return value of function with ‘nodiscard’ attribute”)
  • 若配合 -Werror/WX,警告直接变编译错误
  • 用户仍可用显式丢弃绕过:(void)find_value(v, 42);[[maybe_unused]] auto r = find_value(v, 42);

⚠️ 容易踩的坑:只在头文件声明处加 [[nodiscard]],而定义(.cpp 中)没加——没问题,属性只作用于声明;但若在定义处加了而声明没加,部分编译器可能不识别(因为调用点看到的是声明)。

[[maybe_unused]][[noreturn]] 的关系

三者互不干扰,解决不同问题:

  • [[nodiscard]] 约束「调用方」:你不能随便扔掉返回值
  • [[maybe_unused]] 告诉编译器「这个变量/参数我暂时不用,别警告」
  • [[noreturn]] 告诉编译器「这函数永不返回」,用于 std::abort()throw

它们可以共存,比如一个从不返回但返回值又必须检查的函数(极少,但语法允许):

[[nodiscard]] [[noreturn]] std::optional get_config_value();

真正容易被忽略的是:这个属性对「隐式转换构造函数返回的临时对象」也生效,比如 [[nodiscard]] struct Error { Error(int); };,然后写 func();(其中 func 返回 Error),也会被警告——很多人只想到普通函数,忘了类型本身也能被标记。

相关专题

更多
string转int
string转int

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

315

2023.08.02

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

271

2023.10.25

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

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

521

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

254

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

206

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1463

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

617

2023.11.24

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

0

2026.01.14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 6.7万人学习

C 教程
C 教程

共75课时 | 4万人学习

C++教程
C++教程

共115课时 | 12.2万人学习

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

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