摘要: ¹7-1:在同一项目组或产品组内,要有一套统一的为集成测试与系统联调准备的调测开关及相应打印函数,并且要有详细的说明说明:本规则是针对项目组或产品组的。¹7-2:在同一项目组或产品组内,调测打印出的信息串的格式要有统一的形式。信息串中至少要有所在模块名(或源文件名)及行号说明:统一的调测信息格式便于集成测试。¹7-3:编程的同时要为单元测试选择恰当的测试点,并仔细构造测试代码、测试用例,同时给出明确的注释说明。测试代码部分应作为(模块中的)一个子模块,以方便测试代码在模块中的安装与拆卸(通过调测开关)说明:为单元测试而准备。¹7-4:在进行集成测试/系统 阅读全文
posted @ 2012-12-19 12:35 泪霜雪 阅读(303) 评论(0) 推荐(0) 编辑
摘要: ¹6-1:对所调用函数的错误返回码要仔细、全面地处理¹6-2:明确函数功能,精确(而不是近似)地实现函数设计¹6-3:编写可重入函数时,应注意局部变量的使用(如编写C/C++语言的可重入函数时,应使用auto即缺省态局部变量或寄存器变量)说明:编写C/C++语言的可重入函数时,不应使用static局部变量,否则必须经过特殊处理,才能使函数具有可重入性。¹6-4:编写可重入函数时,若使用全局变量,则应通过关中断、信号量(即P、V操作)等手段对其加以保护说明:若对所使用的全局变量不加以保护,则此函数就不具有可重入性,即当多个进程调用此函数时,很有可能使有关全 阅读全文
posted @ 2012-12-19 12:31 泪霜雪 阅读(457) 评论(0) 推荐(0) 编辑
摘要: ¹5-1:去掉没必要的公共变量说明:公共变量是增大模块间耦合的原因之一,故应减少没必要的公共变量以降低模块间的耦合度。¹5-2:仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系说明:在对变量声明的同时,应对其含义、作用及取值范围进行注释说明,同时若有必要还应说明与其它变量的关系。¹5-3:明确公共变量与操作此公共变量的函数或过程的关系,如访问、修改及创建等说明:明确过程操作变量的关系后,将有利于程序的进一步优化、单元测试、系统联调以及代码维护等。这种关系的说明可在注释或文档中描述。示例:在源文件中,可按如下注释形式说明。RELATIONSystem_ 阅读全文
posted @ 2012-12-19 12:30 泪霜雪 阅读(247) 评论(0) 推荐(0) 编辑
摘要: ¹4-1:注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级说明:防止阅读程序时产生误解,防止因默认的优先级与设计思想不符而导致程序出错。示例:下列语句中的表达式word = (high << 8) | low(1)if ((a | b) && (a & c))(2)if ((a | b) < (c & d))(3)如果书写为:high << 8 | lowa | b && a & ca | b < c & d由于high << 8 | low = ( h 阅读全文
posted @ 2012-12-19 12:29 泪霜雪 阅读(197) 评论(0) 推荐(0) 编辑
摘要: ¹3-1:标识符的命名要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写,避免使人产生误解说明:较短的单词可通过去掉“元音”形成缩写;较长的单词可取单词的头几个字母形成缩写;一些单词有大家公认的缩写。示例:如下单词的缩写能够被大家基本认可。temp可缩写为tmp;flag可缩写为flg;statistic可缩写为stat ;increment可缩写为inc;message可缩写为msg;¹3-2:命名中若使用特殊约定或缩写,则要有注释说明说明:应该在源文件的开始之处,对文件中所使用的缩写或约定,特别是特殊的缩写,进行必要的注释说明。¹3-3:自己 阅读全文
posted @ 2012-12-19 12:28 泪霜雪 阅读(475) 评论(0) 推荐(0) 编辑
摘要: ¹2-1:一般情况下,源程序有效注释量必须在20%以上说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。¹2-2:说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等,头文件的注释中还应有函数功能简要说明示例:下面这段头文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内。/******************************************* 阅读全文
posted @ 2012-12-19 12:27 泪霜雪 阅读(460) 评论(0) 推荐(0) 编辑
摘要: ¹1-1:程序块要采用缩进风格编写,缩进的空格数为4个说明:对于由开发工具自动生成的代码可以有不一致。¹1-2:相对独立的程序块之间、变量说明之后必须加空行示例:如下例子不符合规范。if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni= ssn_data[index].ni;应如下书写if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;re 阅读全文
posted @ 2012-12-19 12:26 泪霜雪 阅读(373) 评论(0) 推荐(0) 编辑