当前位置: 首页 > news >正文

【规范】C/C++注释格式

1. 文件

/******************************************************************************************************************
* Copyright (C): 本代码所有版权为ysq所有,任何个人或者组织不得以任何方式复制、转载以挪作他用,否则将构成对ysq的产权知识侵权。
* @file       : Command.h
* @brief      : // 对该文件的解析
* @autor      : Ysq
* @emil:      : 694622692@qq.com
* @version    : 1.0.0.0
* @date       : 2019/3/29     00:27     
******************************************************************************************************************/

2. 函数

/** 
 * @brief 函数简要说明-测试函数
 * @param index    参数1
 * @param t        参数2 @see CTest
 *
 * @return 返回说明
 *     -<em>false</em> fail
 *     -<em>true</em> succeed
 */

3. 类,结构,枚举标注

/**
 * @brief 类的简单概述 \n(换行)
 * 类的详细概述
 */

参考文献

A.R.T.C/C++注释规范.https://www.cnblogs.com/aspiration2016/p/8433122.html


作者:对着天说晚安
链接:https://www.jianshu.com/p/f4dbbecf957c
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

相关文章:

  • 【FreeRTOS】FreeRTOS 笔记---定时器
  • GIT个人手册
  • 【FreeRTOS】FreeRTOS队列
  • 【GIT】git 合并分支和解决冲突
  • 【GIT】使用git pull文件时和本地文件冲突怎么办?
  • 【GIT】Git、GitHub、GitLab三者之间的联系以及区别
  • 【GIT】git-commit Angular规范--- 编辑中
  • 【分屏】2秒钟实现 Windows窗口多分屏的进阶技巧
  • 【GIT】Commit message 和 Change log 编写指南
  • while(1)和for(;;)的区别
  • 【GitFlow】GIT 工作流(GitFlow-如何使用Git的约定)
  • 【mesh】ESP32 官方文档(十六)ESP-MESH 编程指南
  • 【定位】TOF与TDOA
  • 【工具】source insight的使用方法整理|sourceinsight
  • 【大小端】大小端(数据在内存中的存储)
  • 《用数据讲故事》作者Cole N. Knaflic:消除一切无效的图表
  • Electron入门介绍
  • interface和setter,getter
  • JavaScript 是如何工作的:WebRTC 和对等网络的机制!
  • Js基础——数据类型之Null和Undefined
  • JS学习笔记——闭包
  • MaxCompute访问TableStore(OTS) 数据
  • MYSQL如何对数据进行自动化升级--以如果某数据表存在并且某字段不存在时则执行更新操作为例...
  • Odoo domain写法及运用
  • SpingCloudBus整合RabbitMQ
  • VUE es6技巧写法(持续更新中~~~)
  • 不用申请服务号就可以开发微信支付/支付宝/QQ钱包支付!附:直接可用的代码+demo...
  • 产品三维模型在线预览
  • 多线程事务回滚
  • 关于使用markdown的方法(引自CSDN教程)
  • 浅谈JavaScript的面向对象和它的封装、继承、多态
  • 微信支付JSAPI,实测!终极方案
  • 小程序开发之路(一)
  • 小李飞刀:SQL题目刷起来!
  • 源码安装memcached和php memcache扩展
  • 正则表达式
  • 06-01 点餐小程序前台界面搭建
  • [地铁译]使用SSD缓存应用数据——Moneta项目: 低成本优化的下一代EVCache ...
  • C# - 为值类型重定义相等性
  • python最赚钱的4个方向,你最心动的是哪个?
  • # Panda3d 碰撞检测系统介绍
  • ###C语言程序设计-----C语言学习(6)#
  • #stm32整理(一)flash读写
  • (Bean工厂的后处理器入门)学习Spring的第七天
  • (TipsTricks)用客户端模板精简JavaScript代码
  • (二)linux使用docker容器运行mysql
  • (附源码)小程序 交通违法举报系统 毕业设计 242045
  • (紀錄)[ASP.NET MVC][jQuery]-2 純手工打造屬於自己的 jQuery GridView (含完整程式碼下載)...
  • (三)Hyperledger Fabric 1.1安装部署-chaincode测试
  • (详细版)Vary: Scaling up the Vision Vocabulary for Large Vision-Language Models
  • (一)SpringBoot3---尚硅谷总结
  • (终章)[图像识别]13.OpenCV案例 自定义训练集分类器物体检测
  • (转)可以带来幸福的一本书
  • .net6 webapi log4net完整配置使用流程
  • .net安装_还在用第三方安装.NET?Win10自带.NET3.5安装