第五章 编码规范之标示符与变量.pptxVIP

程序设计语言编码规范江苏微软技术中心第五章编码规范之标示符，变量教学内容标示符规范1.标识符的命名要清晰、明了，有明确含义（望名知意），同时使用完整的单词或大家基本可以理解的缩写，避免使人产生误解。使用名词作标示符。说明：较短的单词可通过去掉“元音”形成缩写；较长的单词可取单词的头几个字母形成缩写；一些单词有大家公认的缩写。标示符规范示例：如下单词的缩写能够被大家基本认可。temp 可缩写为 tmp ;flag 可缩写为 flg ;statistic 可缩写为 stat ;increment 可缩写为 inc ;message 可缩写为 msg ; 标示符规范2.命名中若使用特殊约定或缩写，则要有注释说明。说明：应该在源文件的开始之处，对文件中所使用的缩写或约定，特别是特殊的缩写，进行必要的注释说明。标示符规范3.自己特有的命名风格，要自始至终保持一致，不可来回变化。说明：个人的命名风格，在符合所在项目组或产品组的命名规则的前提下，才可使用。（即命名规则中没有规定到的地方才可有个人命名风格）。标示符规范4.对于变量命名，禁止取单个字符（如i、j、k...），建议除了要有具体含义外，还能表明其变量类型、数据类型等，但i、j、k作局部循环变量是允许的。说明：变量，尤其是局部变量，如果用单个字符表示，很容易敲错（如i写成j），而编译时又检查不出来，有可能为了这个小小的错误而花费大量的查错时间。标示符规范示例：下面所示的局部变量名的定义方法可以借鉴。int liv_Width其变量名解释如下：l局部变量（Local） （其它：g全局变量（Global）...）i数据类型（Interger）v变量（Variable） （其它：c常量（Const）...）Width 变量含义这样可以防止局部变量与全局变量重名。标示符规范5.命名规范必须与所使用的系统风格保持一致，并在同一项目中统一，比如采用UNIX的全小写加下划线的风格或大小写混排的方式，不要使用大小写与下划线混排的方式，用作特殊标识如标识成员变量或全局变量的m_和g_，其后加上大小写混排的方式是允许的。String user_name;String userName;标示符规范6.避免使用不易理解的数字，用有意义的标识来替代。涉及物理状态或者含有物理意义的常量，不应直接使用数字，必须用有意义的枚举或宏来代替（定义为常量)。示例：如下的程序可读性差。if (Trunk[index].trunk_state == 0){ Trunk[index].trunk_state = 1; ... // program code}标示符规范应改为如下形式。#define TRUNK_IDLE 0#define TRUNK_BUSY 1?if (Trunk[index].trunk_state == TRUNK_IDLE){ Trunk[index].trunk_state = TRUNK_BUSY; ... // program code}变量规范6.去掉没必要的公共变量。说明：公共变量是增大模块间耦合的原因之一，故应减少没必要的公共变量以降低模块间的耦合度。变量规范7.防止局部变量与公共变量同名。说明：若使用了较好的命名规则，那么此问题可自动消除。变量规范8.严禁使用未经初始化的变量作为右值。。说明：特别是在C/C++中引用未经赋值的指针，经常会引起系统崩溃。变量规范9.变量的定义可遵循匈牙利命名法。匈法的表现形式为给变量名附加上类型名前缀，例如：nFoo,szFoo,pFoo,cpFoo分别表示整型变量，字符串型变量，指针型变量和常指针型变量。或按编程语言自身的系统类库的命名风格进行命名。本章总结如对全局变量，命名没有特别的规定在这种情况下，可以采用：　_globName 或 $golbName这样的形式。