C语言代码检查内容(第一阶段)_第1页
C语言代码检查内容(第一阶段)_第2页
C语言代码检查内容(第一阶段)_第3页
C语言代码检查内容(第一阶段)_第4页
全文预览已结束

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

1、c语言代码检查项(第一阶段)第一阶段主要以c语言编程排版为主要检查项,共13条:1. 程序块要采用缩进风格编写,缩进的空格数为4个,目前使用sourceinsight时要求使统一的设置,通过替换统一的global. cf3來实现。2. 不允许把多个短语句(不包括变量定义)写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect. length = 0; reel, width = 0;应如卜-书写rect.length = 0;rect. width = 0;3. if> for、do while> case switch、default 等语句自占一行,且 if、for

2、、do、while等语句的执行语句部分无论多少都要加括号 0 示例:如下例子不符合规范。i f (null = pusercr) return;应如下书写:if (null = pusercr)return;4. 遇条件判断(二二、!二)时,常量放左边,变量放右边,以防出现变“二”的错误。 示例:如下例了不符合规范。if (pusercr = null)return;应如下书写:if (null = pusercr)return;5. 函数的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格,case语句下的情况处理语句也要遵从语句缩进要求。6. 程序块的分界符(如c/c+语言的大括号

3、',和'')应各独占一行并位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定 义以及if、for、do、while> switch、case语句中的程序都要采用如上的缩进方式。 示例:如下例子不符合规范。for (.) ./ program code / program codevoid exampl e fun(voi d) / program code应如下书写。for () / program codeif (.) / program codevoid example_fun(void) / program code7.

4、两个以上的关键字、变量、常呆进行对等操作时,它们之间的操作符之前、之示或者前 后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如一),示不应加 空格。说明:采用这种松散方式编写代码的n的是使代码更加清晰。由于留空格所产牛的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留 空格,如來语句已足够清晰则括号内侧(即左括号后而和右括号询而)不需要加空格, 多重括号间不必加空格,因为在c/c+语言中括号已经是最清晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。 给操作符留空格时不要连续留两个以上空格。示例:a) 逗号、分号只在后而加空格。int

5、a, b, c;b) 比较操作符,赋值操作符二、+二,算术操作符+、”囂,逻辑操作符&&、&“,位域操作符、"等双目操作符的前后加空格。if (current_time = max_time_value)a = b + c;a *二 2;a = b 2;屮”、”7、(地址运算符)等单目操作符前后不加空格。*p二a';内容操作*与内容之间flag = ! isempty; /非操作"!"与内容z间 p = &mem; /地址操作与内容之间 i+;/ +,一内容z间d) >、.前后不加空格。p->id二pid; /

6、"-"指针前后不加空格e) if、for> while> switch等与后面的括号间应加空格,使if等关键字更为突出、明显。if (a >= b) && (c > d)&程序中不允许直接使用数字代表具体含义,需要使用宏和枚举定义后再便用.if(sys io. vga mode = 0)sys_io. vga mode = 1;应使用枚举定义后再使用,使程序可读性更强.if(sys io. vga mode = mode 800x600)sys_io. vga mode = mode024x768;9. 代码中无用的注释和打印

7、应及吋去掉,不应该出现类似11111的无意义注释或打卬,调 试时用的醍目的打印,调试完成应该去掉或改成更有意义的,対理解代码有帮助的打 印.如下列的打印应修改成更有意义的语句:trace cll 11 lllnz,)trace(/z555555555555sys io. vga auto = %drt, sys io. vga auto)trace(sys get gui sys cmd queryjjsb log m0nthn)trace ("rec_num=%dn,z, rec num)io.源文件头部应进行注释,列岀:版权说明、版本号、牛成fi期、作者、模块目的/功 能、主要函

8、数及其功能、修改口志等。示例:下面这段源文件的头注释比较标准。copyright*file name:(c), 2004-2009, ilanbang tech. co., ltd./文件名author:/作者*version:/首次版本例如:vi. 0.0*date:/首次版本完成li期 例如:20091103*description:/ 模块描述history:/历史修改记录* 1. version: / 例如:vi. 0. 1 20091103* author:* modification:1). .2).* 2.说明:description 项描述本文件的内容、功能、内部各部分之间的关

9、系及本文件与 其它文件关系等。history是修改历史记录列表,每条修改记录应包括版木号、修改者及 修改内容简述。11. 函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调 用关系(函数、表)等。示例:下面这段函数的注释比较标准i>1>1>1>1>1>1>1/t% t%1%1%t% t% 1%description:*input:/函数功能、性能等的描述/输入参数说明,包括每个参数的作/用、取值说明及参数间关系。output:/对输出参数的说明。return:/函数返回值的说明3z sxx a%azvx akiz%az asiz

10、 asix azx azx %xzi夕夕 4 "卜 夕a、v、"、夕 4"卜 v、"卜 v、夕a jv、"卜"a jv、"、夕介,、"卜 夕 4"卜"a j"、夕 4 "卜"、夕a "卜 夕 b,、"a、夕 b v、* "*12. 注释格式尽量统一,在代码上方的注释使用“/*/”,在代码右方的注释使用“/”。注释应考虑程序易读及外观排版的因素,使用的语言若是中、英兼冇的,建 议多使用中文,除非能用非常流利准确的英文表达。13. 编译时使用-wall选项,编译完成无警告.更严格的编译警告可以检查很多编码过程中的错误,加快开发进度.-wall nj以检查出判 断语句中赋值的错误:if (pusercr = null)return;ifu-wex

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

最新文档

评论

0/150

提交评论