C语言编码规范.docx

C/C++ 语言编码规范 1) 语言标准化同一个系统中尽量减少编程语言的种类;应使用合同中规定的语言编码,若使用其他语言,应经签约机构批准只用语言的标准部分进行编程。 2 )编程规则汇编语言严格使用暂停( halt )、停止( stop )、等待( wait ); 高级语言原则不 GOTO 语句,只许使用前向 GOTO ,不得使用后向 GOTO ,不在两个程序结构之间跳转,不用 GOTO 语句转 GOTO 语句, 选择便于测试且简单的结构来编程。 3 )程序单元的复杂度应对代码集复杂性进行控制和限制, McCabe 度量是对程序拓扑结构复杂性的度量, McCabe 指数,即程序单元的圈复杂度小于 10 ,它等于强连通的程序图中线性无关的有向环的个数, McCabe 度量实质上把独立路径定义为圈复杂度,不考虑处理复杂度和数据结构复杂度,其特点之一是与所用的高级程序设计语言类型无关。 4 )程序单元规模适量缩小模块的规模,有利于减少复杂性,提高可读性,用高级语言时,每个程序单元源代码行数最多不应超过 200 行,平均不超过 100 行。 5) 程序格式化要求程序结构应完整,有说明和语句格式约定,采用分层缩进格式,使编码的逻辑关系与程序清单的实际位置对应,还要有良好的编程风格。 6 )程序注释好的注释可增强的可理解性,除了提高程序可读性,注释还有两个重要用途,即提供程序的用途和历史信息,它的起源(作者、生成和修改日期)、子程序名和个数以及输入输出需求和格式,其次也提供操作控制信息,指示和建议来帮助维护人员理解代码中不清楚部分, 注释的行数不得少于源程序的 1/5, 注释的意义必须与程序一致,每个模块和程序单元前,必须有一段文字注释,包括名称、版本、入口、开发者姓名、开发单位、开发时间、输出功能和参数,以及要调用和被调用的外部程序,模块清单;在模块和程序单元中,对输入输出、存取、转移、调用、中断入口等,必须有中文注释说明, 至少注释部分有:分支转移语句,输入输出语句、循环语句、调用语句。