序 总则条款 执行情况 说明 号 2-9:对于所有有物理含义的变量、常量,如果 是[]否[]免] 其命名不是充分自注释的,在声明时都必须加以 注释,说明其物理含义。变量、常量、宏的注释 应放在其上方相邻位置或右方 2-10:数据结构声明(包括数组、结构、类、枚 是[]否[]免[] 举等),如果其命名不是充分自注释的,必须加 以注释。对数据结构的注释应放在其上方相邻位 置,不可放在下面:对结构中的每个域的注释放 在此域的右方。 2119局变量要有较详细的注释,包括对其功是[1否】知 能、取值范围、哪些函数或过程存取它以及存取 时注意事项等的说明 2-12:注释与所描述内容进行同样的缩排。是[]香】知 12-13:将注释与其上面的代码用空行隔开。 214:对变量的定义和分支语句(条件分支、是[1否】知 环语句等)必须编写注释。 215:对于sWth语句下的cas语句,如果因为是[1否】知 特殊情况需要处理完一个case后进入下一个 case处理,必须在该case语句处理完、下一个 case语句前加上明确的注释, 3标识符命名 3-1:标识符的命名要清晰、明了,有明确含义 同时使用完整的单词或大家基本可以理解的缩 写,避免使人产生误解 吗9-2:命名中若使用特殊约定或缩写,则要是否]兔 释说明。 3-3:自己特有的命名风格,要自始至终保持是]免 致,不可来回变化 3-4:对于变量命名,禁止取单个字符(如、j是[]否[1免1 k..),建议除了要有具体含义外,还能表明其 变量类型、数据类型等,但i、j、k作局部循环 变量是允许的 3-5:命名规范必须与所使用的系统风格保持是[]否免门 致,并在同一项目中统一,比如采用UNIX的全小 写加下划线的风格或大小写混排的方式,不要使 用大小写与下划线混排的方式。序 号 总 则 条 款 执行情况 说明 ¹2-9：对于所有有物理含义的变量、常量，如果 其命名不是充分自注释的，在声明时都必须加以 注释，说明其物理含义。变量、常量、宏的注释 应放在其上方相邻位置或右方。 是[ ] 否[ ] 免[ ] ¹2-10：数据结构声明(包括数组、结构、类、枚 举等)，如果其命名不是充分自注释的，必须加 以注释。对数据结构的注释应放在其上方相邻位 置，不可放在下面；对结构中的每个域的注释放 在此域的右方。 是[ ] 否[ ] 免[ ] ¹2-11：全局变量要有较详细的注释，包括对其功 能、取值范围、哪些函数或过程存取它以及存取 时注意事项等的说明。 是[ ] 否[ ] 免[ ] ¹2-12：注释与所描述内容进行同样的缩排。 是[ ] 否[ ] 免[ ] ¹2-13：将注释与其上面的代码用空行隔开。 是[ ] 否[ ] 免[ ] ¹2-14：对变量的定义和分支语句（条件分支、循 环语句等）必须编写注释。 是[ ] 否[ ] 免[ ] ¹2-15：对于switch语句下的case语句，如果因为 特殊情况需要处理完一个case后进入下一个 case处理，必须在该case语句处理完、下一个 case语句前加上明确的注释。 是[ ] 否[ ] 免[ ] 3 标识符命名 ¹3-1：标识符的命名要清晰、明了，有明确含义， 同时使用完整的单词或大家基本可以理解的缩 写，避免使人产生误解。 是[ ] 否[ ] 免[ ] ¹3-2：命名中若使用特殊约定或缩写，则要有注 释说明。 是[ ] 否[ ] 免[ ] ¹3-3：自己特有的命名风格，要自始至终保持一 致，不可来回变化。 是[ ] 否[ ] 免[ ] ¹3-4：对于变量命名，禁止取单个字符（如i、j、 k...），建议除了要有具体含义外，还能表明其 变量类型、数据类型等，但i、j、k作局部循环 变量是允许的。 是[ ] 否[ ] 免[ ] ¹3-5：命名规范必须与所使用的系统风格保持一 致，并在同一项目中统一，比如采用UNIX的全小 写加下划线的风格或大小写混排的方式，不要使 用大小写与下划线混排的方式。 是[ ] 否[ ] 免[ ]