C++ Builder编码标准.docVIP

四川托普(TP)集团科技发展有限责任公司 软件开发标准 编号：TP-Q- 页号：1/14 版次：A 第0次修改 标题： C++ Builder编码标准 文件起草部门 技术发展部 批 准 人 批 准 日 期 第一章 命名约定 1 第二章 代码布局格式约定 3 第三章 类型使用约定 3 第四章 表达式约定 4 第五章 控制结构约定 4 第六章 函数及操作符使用约定 4 第七章 类使用约定 5 第八章 模块及访问约定 5 第九章 预编译指令使用约定 5 第十章 注释使用约定 6 第十一章 错误检查及异常处理约定 6 第十二章 其它 7  命名约定 变量名命名约定 变量名应符合ANSI C/C++ 变量名命名规定。如：long nTemp; //True long 4Temp; //False 1．2．变量名使用混合大小写，并以小写字母开头。 如：long nTemp; //normal long NTemp; //abnormal 1．3．声明常量(const)，宏(macro)和枚举常量(enum )时应全部使用大写字母。 如：const double PAI=3.1415926; //noraml const double Pai=3.1415926; //abnoraml #define PAI 3.1415926 //normal #define Pai 3.1415926 //abnormal enum Color{RED,BLUE,GREEN}; //normal enum Color{Red,Blue,Green}; //abnormal 1．4．变量名是用多个单词表示时 1．4．1．当使用混合大小写时，将修饰词放在前面，并且尽量拼写完整 增加可读性。如：maxElement,currentFile 等。 1．4．2．当全部使用大写时，单词之间应用下划线连起来。 如：BUFFER_SIZE,FILE_SIZE 等。 1．5．变量名命名应有意义 1．5．1．一律使用英文字母进行拼写；不用汉语拼音。 1．5．2．变量名大小应至少2~3个字母。(当作为整型循环变量时，可以 使用单个字母。如：i，j，k等。) 如：chrName,hWnd等。 1．5．3．变量名中必须有其类型的修饰前缀。 下表列出一些类型修饰前缀，其它依次类推。 类 型 名 前 缀 例 子 char chr chrName int n nTemp short n nTemp long n nTemp double f fValue long double lf lfValue HANDLE h hWnd HKEY hkey hkeySetName LPSTR lpstr lpstrName BOOL b bSelect LPWSTR lpwstr lpwstrName 1．5．4．变量如果是全局变量时，变量名前应加字母g。 如：gnNumber,gbSelect。 1．5．5．避免使用auto，register修饰词。 1．5．6．尽量不使用Variant类型变量。 2．类名命名约定 2．1．所有类必须以大写字母T开头,其后每一个单词都以大写字母开头 如：TGlobalLocation。 2．2．如果是派生类应在其类名中使用后缀来包含其基(组件)类信息,并且取名 应能较准确描述该类的含义。 如：TColorDialog,TClientForm等。 附件1给出了常用派生类推荐使用的后缀。 如果派生类命名满足两个以上推荐使用的后缀，以最近的派生关系来修饰。 3．对象名命名约定 3．1．所有对象名必须以小写字母开头,其后每一个单词都以大写字母开头 如：dlgFileOpen,strName。 3．2．应该用一致的前缀来命名同一(组件)类对象(指针)，使人们 容易识别对象(指针)的类型。 附件2给出了常用(组件)类对象(指针)推荐使用的前缀。 对于表中没有列出的(组件)类的对象(指针)依次类推。 3．3．对于一个组件只有一个对象(实例)的情况，对象名可以和组件名一样， 并且去掉