序 总则条款 执行情况 说明 号 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的全小 写加下划线的风格或大小写混排的方式,不要使 用大小写与下划线混排的方式。 是[ ] 否[ ] 免[ ]