I变量名前缀.docxVIP

【命名约定】一、变量名的约定：命名规则主要采用匈牙利命名法。进行了一些增删。1. 用小写字母的前缀表示变量的类型，前缀的下一个字母用大写。----------------------------------------------------------------- 前缀类型例子b * Boolean bIsParent by 字节 byFlag ch * char chText c * 类对象 cMain（对象实例）fn Function fnCallback h * Handle（句柄） hWnd i * int n * 无符号整型p * 指针sz,str * 字符串w WORD x,y 坐标 xPos, yPos ----------------------------------------------------------------- 其中，带“*”号的为常用约定。其它前缀：m_ 类成员变量 m_nVal, m_bFlag g_ 全局变量 g_nMsg, g_bFlag 局部变量中可采用如下几个通用变量：nTemp，nResult，I，J（一般用于循环变量）。二、VB中控件的命名：用小写前缀表示类别：fm 窗口cmd 按钮cob combo，下拉式列表框txt 文本输入框lab labal，标签img image，图象pic picture grd Grid，网格scr 滚动条lst 列表框frm fram 【注释规范】一、函数在函数开头，用如下格式注释：/***************************************************************/ /* Function: DelStringFrom string */ /* 从一个String删除另一个String。 */ /* 参数：strByDelete，strToDelete */ /* strByDelete: 被删除的字符串（原来的字符串） */ /* strToDelete: 要从上个字符串中删除的字符串。 */ /* 返回：找到并删除返回0，否则返回-1. */ /***************************************************************/ 二、变量对于非通用的变量，请在定义时加以注释说明，变量定义尽可能放在最开始处。三、文件注释在文件开头注释以下内容：//////////////////////////////////////////////////////////////// // Project: 文件所在的项目名，如：eForum // By: 作者、修改者、...，如：xiaobo、qyz......... // Discription: 说明文件的功能。//////////////////////////////////////////////////////////////// 四、其它函数内各功能模块，如：循环、流程的各分支等，尽可能多的加以注释。程规范1.基本要求1.1 程序结构清析，简单易懂，单个函数的程序行数不得超过100行。1.2 打算干什么，要简单，直接了当，代码精简，避免垃圾程序。1.3 尽量使用标准库函数和公共函数。1.4 不要随意定义全局变量，尽量使用局部变量。1.5 使用括号以避免二义性。2.可读性要求2.1 可读性第一，效率第二。2.2 保持注释与代码完全一致。2.3 每个源程序文件，都有文件头说明，说明规格见规范。2.4 每个函数，都有函数头说明，说明规格见规范。2.5 主要变量（结构、联合、类或对象）定义或引用时，注释能反映其含义。2.7 常量定义（DEFINE）有相应说明。2.8 处理过程的每个阶段都有相关注释说明。2.9 在典型算法前都有注释。2.10 利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位，定义Tab为 6个字节。2.11 循环、分支层次不要超过五层。2.12 注释可以与语句在同一行，也可以在上行。2.13 空行和空白字符也是一种特殊注释。2.14 一目了然的语句不加注释。2.15 注释的作用范围可以为：定义、引用、条件分支以及一段代码。2.16 注释行数（不包括程序头和函数头说明部份）应占总行数的 1/5 到 1/3 。3. 结构化要求3.1 禁止出现两条等价的支路。3.2 禁止GOTO语句。3.3 用 IF 语句来强调只执行两组语句中的一组。禁止 ELSE GOTO 和 ELSE RETURN。3.4 用 CASE 实现多路分支。3.5 避免从循环引出多个出口。3.6 函数只有一个出口。3.7 不使用条件赋值语句。3.8 避免不必要的分支。3.9 不要轻易用条件分支去替换逻辑表达式。4.