文件頭說明 :源程序(如頭文件.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 變量含義