文档介绍：Panorama系统程序开发规范之二
变动前缀类型
a Array
b Boolean
by Byte
c Char //有符号型字符
cb Char Byte //无符号型字符(没多大用处)
cr ColorRef //颜色参考值
cx,cy Length of x,y (ShortInt) //坐标差(长度)
dw Double Word
fn Function
h Handle
i Integer
m_ Member of a class
n Short Integer
np Near Pointer
p Pointer lp Long Pointer
×(str) s String
sz String with Zero End //以字符'\0'结尾的字符串
tm Text //文本内容
w Word
x,y Coordinate //坐标
VC中变量命名时的前缀约定
Array a... //例:CStringArray saText
BOOL b...
UINT n...
int i...
short n...
long l...
WORD w...
DWORD dw...
float f...
char c...
char* psz...
TCHAR* psz...
LPCTSTR lpsz...
CString str...
COLORREF cr...
LPLOGPALETTE lp... (包括LP开头的类型都是这样)
POINT pt...
CPoint pt...
HANDLE h...
HGLOBAL h... (包括H开头的类型都是这样)
说明:
,就在上面规范前加"p" ;
,就在上面规范前加"pp" ;
,则在上面规范前加"m_";
,则在上面规范前加"g_";
"const",命名约定不变;
VC中变量命名时的后缀约定
CWnd* p...Wnd 省去的地方一般为该类的用途(如果是某一个类的成员,则还应该在前加"m_")又如:CView* p...View
局部变量应尽量易懂简洁,使用常见的变量,如Num,nCount,i,j,k,n,len,pos, offset,nReadNum,index,nRet,ret, string,filename临时变量,如ltmp,ftmp,tmpStr,tempStr 。。。
函数命名也应该见名知意。如CalcAllDataStyle(),ReadDocDataFromTime(),GetIndexInfo()
常见的函数Init
_, Open_, Create_, Get_, Set_, Read_, Load_, Write_, Start_, Stop_, Check_, Test_, Fill_, Process_, Sort_, Do_, Select_, Is_, Exist_,_Ex…
禁止使用汉语拼音来命名;
,定义成宏,便于以后维护,如:
#define MAX_DOWNLOADNUM 20
struct DownInfo m_DownInfo[MAX_DOWNLOADNUM];
VC中一些控件的缩写:
ComboBox cmb
Edit edt
Dialog dlg
ListBox lst
Picture pic
Animate ani
3. 编排
函数间要有空行分开,一个程序中的空行数目最好占8%-16% ;
变量的定义尽可能放在最开始处,多态函数和功能相近的函数集中放在一起;
声明变量时对齐变量名,并在定义时加以注释说明;
4. 程序开发环境规约
工作目录结构的规定:
project name(项目名称)
——bin 执行文件
——log 日志文件
——lib 库文件
——include 头文件
——src 源程序
——dat 数据文件
,工程目录下的非工程文件也应该移走,保持工程的清洁,避免混淆难于管理;
,,。避免头文件