c-code编程规范.ppt

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C语言编程规范 机械工程学院 CoME 9 质量保证 9-7：使用变量时要注意其边界值的情况。 示例：如C语言中字符型变量，有效值范围为-128到127。 9-8：留心程序机器码大小（如指令空间大小、数据空间大小、堆栈空间大小等）是否超出系统有关限制。 9-9：为用户提供良好的接口界面，使用户能较充分地了解系统内部运行状态及有关系统出错情况。 9-10：系统应具有一定的容错能力，对一些错误事件（如用户误操作等）能进行自动补救。 * C语言编程规范 机械工程学院 CoME 9 质量保证 9-11：对一些具有危险性的操作代码（如写硬盘、删数据等）要仔细考虑，防止对数据、硬件等的安全构成危害，以提高系统的安全性。 ~~9-12：使用第三方提供的软件开发工具包或控件时，要注意以下几点： （1）充分了解应用接口、使用环境及使用时注意事项。 （2）不能过分相信其正确性。 （3）除非必要，不要使用不熟悉的第三方工具包与控件。 说明：使用工具包与控件，可加快程序开发速度，节省时间，但使用之前一定对它有较充分的了解，同时第三方工具包与控件也有可能存在问题。 ~~9-13：资源文件（多语言版本支持），如果资源是对语言敏感的，应让该资源与源代码文件脱离，具体方法有下面几种：使用单独的资源文件、DLL文件或其它单独的描述文件（如数据库格式） * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 10-1：打开编译器的所有告警开关对程序进行编译。 10-2：在产品软件（项目组）中，要统一编译开关选项。 10-3：通过代码走读及审查方式对代码进行检查。 说明：代码走读主要是对程序的编程风格如注释、命名等以及编程时易出错的内容进行检查，可由开发人员自己或开发人员交叉的方式进行；代码审查主要是对程序实现的功能及程序的稳定性、安全性、可靠性等进行检查及评审，可通过自审、交叉审核或指定部门抽查等方式进行。 * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 10-1：同产品软件（项目组）内，最好使用相同的编辑器，并使用相同的设置选项。 说明：同一项目组最好采用相同的智能语言编辑器，如Muiti Editor，Visual Editor(我使用Ultra Editor,ilan2003)等，并设计、使用一套缩进宏及注释宏等，将缩进等问题交由编辑器处理。 10-2：要小心地使用编辑器提供的块拷贝功能编程。 说明：当某段代码与另一段代码的处理功能相似时，许多开发人员都用编辑器提供的块拷贝功能来完成这段代码的编写。由于程序功能相近，故所使用的变量、采用的表达式等在功能及命名上可能都很相近，所以使用块拷贝时要注意，除了修改相应的程序外，一定要把使用的每个变量仔细查看一遍，以改成正确的。不应指望编译器能查出所有这种错误，比如当使用的是全局变量时，就有可能使某种错误隐藏下来。 * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 10-3：合理地设计软件系统目录，方便开发人员使用。 说明：方便、合理的软件系统目录，可提高工作效率。目录构造的原则是方便有关源程序的存储、查询、编译、链接等工作，同时目录中还应具有工作目录----所有的编译、链接等工作应在此目录中进行，工具目录----有关文件编辑器、文件查找等工具可存放在此目录中。 * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 10-4：某些语句经编译后产生告警，但如果你认为它是正确的，那么应通过某种手段去掉告警信息。 ~~说明：在Borland C/C++中，可用“#pragma warn”来关掉或打开某些告警。 示例： #pragma warn -rvl // 关闭告警 int examples_fun( void ) { // 程序，但无return语句。 } #pragma warn +rvl // 打开告警 编译函数examples_fun时本应产生“函数应有返回值”告警，但由于关掉了此告警信息显示，所以编译时将不会产生此告警提示。 * C语言编程规范 机械工程学院 CoME 10 代码编辑、编译、审查 10-5：使用代码检查工具（如C语言用PC-Lint）