通用编码规范.pdfVIP

通通用用编编码码规规范范

11..引引言言

本规范编制是为了指导程序员编码，其目的是：

1）改善软件的可性，使程序员尽快而彻底地理解新的代码；

2）防止新接触本语言的人出于节省时间的需要，自创与组织成员不相容的一套风

格；

3）防止新接触本语言的人一次次的犯同样的错误；

4）新加入的程序员可以很快的适应环境；

5）在一致的环境下，减少程序员犯错的机会。

22..编编排排风风格格约约定定

编排风格应遵循下列规定：

1）严格采用阶梯层次组织程序代码：各层次缩进的分格采用VC的缺省风格，即每

层次缩进为4格。功能块、语句块的边界大括号一律独占一行，相匹配的大括号

在同一列，对继行则要求再缩进4格；

2）对变量的定义，尽量位于函数的开始位置；

3）函数名之后不要留空格，紧跟左括号‘（’，以与关键字区别；

4）‘（’向后紧跟，‘）’、‘，’、‘;’向前紧跟，紧跟处不留空格；

5）‘，’之后要留空格，如Function(x,y,z)。如果‘;’不是一行的结束符号，

其后要留空格，如for(initialization;condition;update)；

6）赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符，如“=”、

“+=”“=”、“=”、“+”、“*”、“%”、“”、“||”、“”,“^”

等二元操作符的前后应当加空格；但是，对于表达式比较长的for语句和if语

句，为了紧凑起见可以适当地去掉一些空格，如for(i=0;i10;i++)和if

((a=b)(c=d))；

7）一元操作符如“!”、“~”、“++”、“--”、“”（地址运算符）等前后不

加空格。“［］”、“.”、“-”等操作符前后不加空格；

8）修饰符*和＆紧靠变量名。

9）各个大的功能块之间最好留一空行以及适当的注释；

10）if、for、do、while、switch、case、default等语句自占一行，且if、for、

do、while等语句的执行语句部分无论多少都要加括号{}，对“return语句”

不要求;

11）不允许把多个短语句写在一行中，即一行只写一条语句；

12）长表达式要在低优先级操作符处拆分成新行，操作符放在新行之首（以便突出

操作符），拆分出的新行要进行适当的缩进，使排版整齐，语句可；

13）对于switch…case…语句，break语句要放在{}内。

33..界界面面设设计计约约定定

界面设计应遵循下列约定：

1）一般选系统常用的字体，汉字字体选宋体，字体大小为10；

2）为方便用户的使用，所有的输入控件该按tab键排序；

3）要考虑到用户可能会用到不同的分辨率，在开发时使用当时流行的分辨率。

44..命命名名规规则则

44..11..变变量量命命名名

变量命名遵循下列约定：

1）变量名采用匈牙利命名法，命名必须具有一定的实际意义；

2）形式为s_xAbcFgh：s由变量的作用范围确定；x由变量类型确定；Abc、Fgh表

示连续意义字符串，多个单词之间无间隙；例如：m_strTableName；

3）尽量避免用中文的拼音；对非通用的变量，在定义时加入注释说明；

4）全局变量用g_开头，即：变量名=g_+变量类型+变量（或缩写）

静态变量用s_开头，即：变量名=s_+变量类型+变量（或缩写）

成员变量用m_开头，即：变量名=m_+变量类型+变量（或缩写）

5）枚举类型（enum）的变量用e做类型前缀；

6）struct类型的变量用s做类型前缀。

44..22..常常量量命命名名和和宏宏定定义义

常量命名与宏定义遵循下列约定：

1）常量和宏定义必须全部用大写字母，中间可根据意义的连续性用下划线连接，

每一个变量定义的右侧必须有一简单的注释；说明其作用；

2）用宏定义表达式时，要使用完备的括号。

44..33..函函数数命命名名