C++注释
来源:互联网 发布:免费网络考试系统 编辑:程序博客网 时间:2024/06/08 14:50
下面的文章转载自:
http://hi.baidu.com/buptyoyo/blog/item/fc8bdfee2ea1793326979114.html
http://blog.csdn.net/lincyang/article/details/6020785#t0
1 源文件头部注释
Ø 列出:版权、作者、编写日期和描述。
Ø 示例:
/************************************************* Copyright:bupt Author: Date:2010-08-25 Description:描述主要实现的功能 **************************************************/
每行不要超过80个字符的宽度。
2 函数头部注释
Ø功能、输入参数、输出参数、返回值、调用关系(函数、表)等。
Ø 示例:下面这段函数的注释比较标准,当然,并不局限于此格式,但上述信息建议
要包含在内。
/************************************************* Function: // 函数名称 Description: // 函数功能、性能等的描述 Calls: // 被本函数调用的函数清单 Table Accessed: // 被访问的表(此项仅对于牵扯到数据库操作的程序) Table Updated: // 被修改的表(此项仅对于牵扯到数据库操作的程序) Input: // 输入参数说明,包括每个参数的作 // 用、取值说明及参数间关系。 Output: // 对输出参数的说明。 Return: // 函数返回值的说明 Others: // 其它说明 *************************************************/
3 数据结构声明的注释(包括数组、结构、类、枚举等)
Ø如果其命名不是充分自注释的,必须加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释放在此域的右方。
Ø 示例:可按如下形式说明枚举/数据/联合结构。
/* sccp interface with sccp user primitive message name */ enum SCCP_USER_PRIMITIVE { N_UNITDATA_IND, /* sccp notify sccp user unit data come */ N_NOTICE_IND, /* sccp notify user the No.7 network can not */ /* transmission this message */ N_UNITDATA_REQ, /* sccp user's unit data transmission request*/ };
4 全局变量的注释
Ø 包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。
Ø示例:
/* The ErrorCode when SCCP translate */ /* Global Title failure, as follows */ // 变量作用、含义
5 对代码的注释
注释总是加在程序的需要一个概括性说明或不易理解或易理解错的地方。注释语言应该简练、易懂而又含义准确,避免二义性;所采用的语种首选是中文,如有输入困难、编译环境限制或特殊需求也可采用英文。注释应与其描述的代码相近,对代码的注释统一放在其上方,避免在一行代码或表达式中间使用注释。上方注释与其上面的代码用空行隔开(较紧凑的代码除外)。
注意:注释应与所描述内容进行同样的缩进。
0 0
- C 注释
- 注释转换<C注释-->C++注释>
- c语言注释转换(c注释转换成c++注释)
- c语言中的注释
- 删除C/C++注释
- C语言注释风格
- 关于C中的注释
- dm9000x.c注释
- C语言注释
- c去除注释
- 去除c中的注释
- C语言嵌套注释
- c语言注释---状态机
- 移出c程序注释
- camshiftdemo C注释
- C符号之注释
- pdflush.c代码注释
- C编译器 嵌套注释
- 360浏览器模式问题
- ArcGIS教程:扩展 (Spatial Analyst)
- AVFoundation基础知识
- streamingAssetsPath 内文件读取
- hdu2222(Keywords Search)
- C++注释
- android 常用tips
- DB2数据类型转换函数
- 常用快捷键
- 3D Touch初探
- mybatis中的resultType和resultMap
- 使用freopen在文件与控制台之间切换输入、输出
- 海量互联网服务设计中的有损价值观
- 第一次打开CSDN博客