2014年C语言编程及命名规范.pptVIP

第二部分 C语言编程规范 2、可读性要求 例四：switch语句的使用 正确的例子： switch(code) { case 0: break; case 1: break; default: break; } 内容缩进2个空格，层次清楚，可读性强。 第二部分 C语言编程规范 3、结构化要求 3.1 禁止出现两条等价的支路。3.2 一般禁止GOTO语句。3.3 用 IF 语句来强调只执行两组语句中的一组。禁止 ELSE GOTO。3.4 用 CASE 实现多路分支。3.5 避免从循环引出多个出口。3.6一般函数只有一个出口。3.7 不使用条件赋值语句。3.8 避免不必要的分支。3.9 不要轻易用条件分支去替换逻辑表达式。 第二部分 C语言编程规范 4、正确性与容错性要求 4.1 程序首先是正确，其次是优美4.2 无法证明你的程序没有错误，因此在编写完一段程序后，应先根据详细设计回头检查。4.3 改一个错误时可能产生新的错误，因此在修改前首先考虑对其它程序的影响。4.4 所有变量在调用前必须被初始化。4.5 对所有的用户输入，必须进行合法性检查。4.6 程序与环境或状态发生关系时，必须主动去处理发生的意外事件，如文件能否逻辑锁定、权限设定等。4.7 单元测试也是编程的一部份，提交联调测试的程序必须通过单元测试。 第二部分 C语言编程规范 5、可重用性要求 5.1 重复使用的完成相对独立功能的算法或代码应抽象为公共控件。5.2 公共控件应考虑OO思想，减少外界联系，考虑独立性或封装性。5.3 公共控件应建立使用模板。 第二部分 C语言编程规范 6、注释 6.1根据项目要求设定注释语言; 6.2文件开始注释内容包括:公司名称、版权、作者名称、时间、模块用途、背景介绍等,复杂的算法需要加上流程说明; 6.3函数注释包括:输入、输出、函数描述、流程处理、全局变量、调用样例等,复杂的函数需要加上变量用途说明; 6.4程序中注释包括:修改时间和作者、方便理解的注释等; 第二部分 C语言编程规范 6、注释 例一: 文件开头的注释模板 /****************************************************************** ** 文件名： ** Copyright (c) 1993-2007 *********公司技术开发部 ** 创建人： ** 日 期： ** 功能描述： ** 版 本： ** 修改人： ** 修改内容： ** 日 期： ******************************************************************/ 第二部分 C语言编程规范 6、注释 例二: 函数开头的注释模板 /***************************************************************** ** 函数名: ** 输 入: a，b ** a--- ** b--- ** 输 出: x ** x 为 1, 表示... ** x 为 0, 表示... ** 功能描述: ****************************************************************/ 第二部分 C语言编程规范 6、注释 例三: 程序中（函数内部）的注释模板 //注释内容 代码； 代码； //注释内容 一般在函数内部的注释不用/* */，以避免屏蔽函数一些代码时产生错误。 结束语 谢谢大家，CXL C语言程序设计 授课专业：软件技术专业 前言 规范的重要性 今天人们越来越明白软件设计更多地是一种工程，而不是一种个人艺术。由于大型产品的开发通常由很多的人协同作战，如果不统一编程规范，最终合到一起的程序，其可读性将较差，这不仅给代码的理解带来障碍，增加维护阶段的工作量，同时不规范的代码隐含错误的可能性也比较大。 前言 规范的重要性 BELL实验室的研究资料表明，软件错误中18%左右产生于概要设计阶段，15%左右产生于详细设计阶段，而编码阶段产生的错误占的比例则接近50%;分析表明，编码阶段产生的错误当中，语法错误大概占20%左右，而由于未严格检查软件逻辑导致的错误、函数(模块)之间接口错误及由于代码可理解度低导致优化维护阶段对代码的错误修改引起的错误则占了一半以上。可见，提高软件质量必须降低编码阶段的错误率。如何有效降低编码阶段的错误呢?BELL实验室的研究人员制定了详细的软件编程规范，并培训每一位程序员，最终的结果把编码阶段的错误降至10%左右