讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法

千强君_1362

千强君_1362

发布时间:2025-07-05 10:38:01

|

511人浏览过

|

来源于php中文网

原创

c++17引入的[[nodiscard]]和[[maybe_unused]]属性用于提升代码质量和可读性。[[nodiscard]]用于提醒开发者不要忽略关键返回值,适用于函数、枚举或结果结构体,如std::optional::value();若忽略返回值且编译器支持相关选项(如-wunused-result),则会触发警告。[[maybe_unused]]则用于抑制未使用变量或函数的警告,适用于调试代码、条件编译或参数占位符,如调试函数、release构建中未使用的变量或回调中未用参数。两者虽不影响程序行为,但有助于减少误用和冗余警告。

现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法

C++17 开始引入了属性说明符(Attribute Specifiers),允许开发者以更标准的方式给代码添加元信息。其中 [[nodiscard]] 和 [[maybe_unused]] 是两个比较实用、使用频率较高的属性,它们分别用于提示编译器在特定情况下给出警告。

现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法

下面来看看这两个属性的具体用途和使用方式。

现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法

[[nodiscard]]:提醒你不要忽略返回值

这个属性最常见的用途是加在函数或者枚举类型上,告诉调用者“这个返回值你不应该忽略”。

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

使用场景:

  • 函数执行有副作用或返回关键数据,比如错误码、结果状态等。
  • 如果调用者忽略了返回值,可能造成 bug,例如资源未释放或状态判断缺失。
[[nodiscard]] int compute_value();

// 调用时如果忽略返回值,有些编译器会报警告
compute_value(); // 可能触发 warning: ignoring return value

常见做法:

  • 用于封装操作结果的类或结构体:

    C++14
    C++14

    C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

    下载
    现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法
    [[nodiscard]] struct Result {
        bool success;
        std::string message;
    };
  • 用于标准库中的一些函数,如 std::optional<t>::value()</t> 也有 [[nodiscard]] 属性。

注意:并不是所有编译器都会默认开启这个检查,需要配合合适的编译选项(如 -Wunused-result)才能生效。

[[maybe_unused]]:告诉编译器这个变量/函数可能不被使用

有时候我们定义了一个变量、函数或参数,但只在某些条件下才使用它,比如调试信息、平台差异处理等。这时候为了避免编译器报出“unused variable”之类的警告,就可以加上这个属性。

使用示例:

[[maybe_unused]] void debug_log(const std::string& msg) {
    // 仅在调试构建中使用
    std::cout << msg << std::endl;
}

也可以用在变量上:

void func(int flag) {
    [[maybe_unused]] int debug_flag = flag;
    // debug_flag 可能在 release 构建中没被用到
}

适用情况包括:

  • 调试函数或变量
  • 条件编译中的备用代码
  • 参数占位符(如回调函数中未使用的参数)
void callback([[maybe_unused]] int event_type, int data) {
    // event_type 某些情况下可能不用
}

小结

  • [[nodiscard]] 提醒不要忽略返回值,适合用于重要函数或结果类型。
  • [[maybe_unused]] 避免无用变量/函数的警告,适合用于调试或条件分支中。

这两个属性虽然不能改变程序行为,但可以提高代码可读性和安全性,同时减少不必要的编译警告。

基本上就这些,用起来也不复杂,但在实际项目中很容易被忽略。

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

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

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

5514

2025.06.09

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

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

5691

2025.07.04

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

60

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

60

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

160

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

120

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

120

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

100

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn