文件头说明 :源程序(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等,头文件的注释中还应有函数功能简要说明。
/************************************************************
版权信息:
文件名: test.cpp
作者: 日期:
功能:
版本:
历史修改记录
<作者> <日期> <版本 > <说明>
***********************************************************/
常量、编译宏命名
说明:常量、编译宏全部大写,单词间使用下划线分隔。
对于变量命名,禁止取单个字符(如i、j、k...),建议除了要有具体含义外,还能表明其变量类型、数据类型等,但i、j、k作局部循环变量是允许的。说明:变量,尤其是局部变量,如果用单个字符表示,很容易敲错(如i写成j),而编译时又检查不出来,有可能为了这个小小的错误而花费大量的查错时间。
对于变量命名,禁止取单个字符(如i、j、k...),建议除了要有具体含义外,还能表明其变量类型、数据类型等,但i、j、k作局部循环变量是允许的。说明:变量,尤其是局部变量,如果用单个字符表示,很容易敲错(如i写成j),而编译时又检查不出来,有可能为了这个小小的错误而花费大量的查错时间。
示例:下面所示的局部变量名的定义方法可以借鉴。
int liv_Width
其变量名解释如下:
l 局部变量(Local) (其它:g 全局变量(Global)...)
i 数据类型(Interger)
boolean b
char c
long l
float f
double d
int i
unsigned int ui
指针 p
结构 s
输入管脚 bi
输出管脚 bo
v 变量(Variable) (其它:c 常量(Const)...)
Width 变量含义