好文档就是一把金锄头!
欢迎来到金锄头文库![会员中心]
电子文档交易市场
安卓APP | ios版本
电子文档交易市场
安卓APP | ios版本

C语言编程规范.ppt

124页
  • 卖家[上传人]:pu****.1
  • 文档编号:588193185
  • 上传时间:2024-09-07
  • 文档格式:PPT
  • 文档大小:900.51KB
  • / 124 举报 版权申诉 马上下载
  • 文本预览
  • 下载提示
  • 常见问题
    • C语言编程规范语言编程规范 主要内容C语言编程规范语言编程规范1 排版排版2 注释注释3 标识符命名标识符命名4 可读性可读性5 变量、结构变量、结构6 函数、过程函数、过程7 可测性可测性8 程序效率程序效率9 质量保证质量保证10 代码编辑、编译、审查代码编辑、编译、审查11 代码测试、维护代码测试、维护12 宏宏2 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版3 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-1:程序块要采用缩进风格编写,缩进的空格数为:程序块要采用缩进风格编写,缩进的空格数为4个1-2:相对独立的程序块之间、变量说明之后必须加空行相对独立的程序块之间、变量说明之后必须加空行1-3:较长的语句(:较长的语句(>80字符)要字符)要分成多行书写分成多行书写,长表达式要在低优先级,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使的缩进,使排版整齐排版整齐,语句可读语句可读report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)                      && (n7stat_stat_item_valid (stat_item))                      && (act_task_table[taskno].result_data != 0));4 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。

      示例:if ((taskno < max_act_task_number) && (n7stat_stat_item_valid (stat_item))){ ... // program code}for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length) && (j < NewKeyword.word_length); i++, j++){ ... // program code}5 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-5:若:若函数或过程中的函数或过程中的参数参数较长,则要进行适当的划分较长,则要进行适当的划分示例:示例:n7stat_str_compare((BYTE *) & stat_object, (BYTE *) & (act_task_table[taskno].stat_object), sizeof (_STAT_OBJECT));n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object );1-6:不允许把多个短语句写在一行中,即:不允许把多个短语句写在一行中,即一行只写一条语一行只写一条语句句。

      6 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-7::if、、for、、do、、while、、case、、switch、、default等语句自占一行,且等语句自占一行,且if、、for、、do、、while等语句的等语句的执行语句执行语句部分无论多少都要部分无论多少都要加括号加括号{} 1-8::对齐只使用空格键对齐只使用空格键,不使用,不使用TAB键说明:以免用不同的编辑器阅读程序时,因TAB键所设置的空格数目不同而造成程序布局不整齐,不要使用BC作为编辑器合版本,因为BC会自动将8个空格变为一个TAB键,因此使用BC合入的版本大多会将缩进变乱1-9:函数或过程的开始、结构的定义及循环、判断等语句中的代码都要:函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格采用缩进风格,,case语句下的情况处理语句也要遵从语句缩进要求语句下的情况处理语句也要遵从语句缩进要求7 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-10:程序块的分界符(如:程序块的分界符(如C/C++语言的语言的大括号大括号‘{’和和‘}’))应各独占一行并应各独占一行并且位于同一列且位于同一列,同时与引用它们的语句左对齐。

      在函数体的开始、类的定义、,同时与引用它们的语句左对齐在函数体的开始、类的定义、结构的定义、枚举的定义以及结构的定义、枚举的定义以及if、、for、、do、、while、、switch、、case语句语句中的程序都要采用如上的缩进方式中的程序都要采用如上的缩进方式示例:如下例子不符合规范for (...) { ... // program code}if (...) { ... // program code }void example_fun( void ) { ... // program code }应如下书写for (...) { ... // program code}if (...) { ... // program code}void example_fun( void ){ ... // program code}8 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版1-11:在两个以上的:在两个以上的关键字、变量、常量关键字、变量、常量进行进行对等操作对等操作时,它们之间的时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如-系密切的立即操作符(如->),后不应加空格。

      后不应加空格说明:采用这种松散方式编写代码的目的是使代码更加清晰 由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格.如括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括号已经是最清晰的标志了在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格给操作符留空格时不要连续留两个以上空格9 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版(1) 逗号、分号只在后面加空格逗号、分号只在后面加空格int a, b, c; (2)比较操作符比较操作符, 赋值操作符赋值操作符"="、、 "+=",算术操作符,算术操作符"+"、、"%",逻辑,逻辑操作符操作符"&&"、、"&",位域操作符,位域操作符"<<"、、"^"等双目操作符等双目操作符的前后加空格的前后加空格if (current_time >= MAX_TIME_VALUE) a = b + c;a *= 2;a = b ^ 2;10 C语言编程规范语言编程规范机械工程学院机械工程学院CoME1 排版(3)"!"、、"~"、、"++"、、"--"、、"&"(地址运算符)等(地址运算符)等单目操作符单目操作符前后不加空格。

      前后不加空格p = 'a'; // 内容操作"*"与内容之间flag = !isEmpty; // 非操作"!"与内容之间p = &mem; // 地址操作"&" 与内容之间i++; // "++","--"与内容之间(4)"->"、、"."前后不加空格前后不加空格p->id = pid; // "->"指针前后不加空格(5) if、、for、、while、、switch等与后面的括号间应加空格,等与后面的括号间应加空格,使使if等关键字更等关键字更为突出、明显为突出、明显if (a >= b && c > d)11 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释12 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-1:一般情况下,源程序有效注释量必须在:一般情况下,源程序有效注释量必须在20%以上13 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释/************************************************* Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. File name: // 文件名文件名 Author: Version: Date: // 作者、版本及完成日期作者、版本及完成日期 Description: // 用于详细说明此程序文件完成的主要功能,与其他模块用于详细说明此程序文件完成的主要功能,与其他模块 // 或函数的接口,输出值、取值范围、含义及参数间的控或函数的接口,输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系制、顺序、独立或依赖等关系 Others: // 其它内容的说明其它内容的说明 Function List: // 主要函数列表,每条记录应包括函数名及功能简要说明主要函数列表,每条记录应包括函数名及功能简要说明 1. .... History: // 修改历史记录列表,每条修改记录应包括修改日期、修改修改历史记录列表,每条修改记录应包括修改日期、修改 // 者及修改内容简述者及修改内容简述 1. Date: Author: Modification: 2. ...*************************************************/2-2::说明性文件说明性文件(如头文件(如头文件.h文件、文件、.inc文件、文件、.def文文件、编译说明文件件、编译说明文件.cfg等)头部应等)头部应进进行注释行注释,注释必须,注释必须列出:列出:版权说明版权说明、、版本号版本号、、生成日期生成日期、、作者作者、、内容内容、、功能功能、、与其它文件的关系与其它文件的关系、、修改日志修改日志等,头文等,头文件的注释中还应有件的注释中还应有函数功能简要说明函数功能简要说明。

      14 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-3::源源文文件件头头部部应应进进行行注注释释,,列列出出::版版权权说说明明、、版版本本号号、、生生成成日日期期、、作者、模块目的作者、模块目的/功能、主要函数及其功能、修改日志等功能、主要函数及其功能、修改日志等示例:下面这段源文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内15 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释说明:说明:Description一项一项描述本文件的描述本文件的内容、内容、功能、功能、内部各部分内部各部分之间的关系之间的关系及及本文本文件与其它文件关系件与其它文件关系等History是是修修改历史记录列表改历史记录列表,,每条修改记录应包每条修改记录应包括修改日期、修改括修改日期、修改者及修改内容简述者及修改内容简述/************************************************************ Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. FileName: test.cpp Author: Version : Date: Description: // 模块描述 Version: // 版本信息 Function List: // 主要函数及其功能 1. ------- History: // 历史修改记录

      参数、返回值、调用关系(函数、表)等示例:下面这段函数的注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内示例:下面这段函数的注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内/************************************************* Function: // 函数名称函数名称 Description: // 函数函数功能、性能功能、性能等的描述等的描述 Calls: // 被本函数调用的函数清单被本函数调用的函数清单 Called By: // 调用本函数的函数清单调用本函数的函数清单 Table Accessed: // 被访问的表(此项仅对于牵扯到数据库操作的程序)被访问的表(此项仅对于牵扯到数据库操作的程序) Table Updated: // 被修改的表(此项仅对于牵扯到数据库操作的程序)被修改的表(此项仅对于牵扯到数据库操作的程序) Input: // 输入参数说明,包括每个参数的作输入参数说明,包括每个参数的作 // 用、取值说明及参数间关系。

      用、取值说明及参数间关系 Output: // 对输出参数的说明对输出参数的说明 Return: // 函数返回值的说明函数返回值的说明 Others: // 其它说明其它说明*************************************************/17 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-5::边边写写代代码码边边注注释释,,修修改改代代码码同同时时修修改改相相应应的的注注释释,,以以保保证证注注释释与与代码的一致性不再有用的注释要删除代码的一致性不再有用的注释要删除2-6::注释的内容要清楚注释的内容要清楚、明了,含义准确,防止注释二义性明了,含义准确,防止注释二义性2-7::避免在注释中使用缩写避免在注释中使用缩写,特别是非常用缩写特别是非常用缩写 说明:在使用缩写时或之前,应对缩写进行必要的说明2-8::注注释释应应与与其其描描述述的的代代码码相相近近,,对对代代码码的的注注释释应应放放在在其其上上方方或或右右方方((对对单单条条语语句句的的注注释释))相相邻邻位位置置,,不不可可放放在在下下面面,,如如放放于于上上方方则则需需与与其上面的代码用空行隔开其上面的代码用空行隔开。

      18 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-9::对对于于所所有有有有物物理理含含义义的的变变量量、、常常量量,,如如果果其其命命名名不不是是充充分分自自注注释释的的,,在在声声明明时时都都必必须须加加以以注注释释,,说说明明其其物物理理含含义义变量、常量、宏的注释应放在其上方相邻位置或右方变量、常量、宏的注释应放在其上方相邻位置或右方2-10::数数据据结结构构声声明明(包包括括数数组组、、结结构构、、类类、、枚枚举举等等),,如如果果其其命命名名不不是是充充分分自自注注释释的的,,必必须须加加以以注注释释对对结结构构中中的的每每个域的注释放在此域的右方个域的注释放在此域的右方19 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释示例:可按如下形式示例:可按如下形式说明说明枚举枚举/数据数据/联合结构联合结构/* sccp interface with sccp user primitive message name */enum SCCP_USER_PRIMITIVE{ N_UNITDATA_IND, /* sccp notify sccp user unit data come */ N_NOTICE_IND, /* sccp notify user the No.7 network can not */ /* transmission this message */ N_UNITDATA_REQ, /* sccp user's unit data transmission request*/};20 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-11::全全局局变变量量要要有有较较详详细细的的注注释释,,包包括括对对其其功功能能、、取取值值范范围围、、哪哪些些函函数或过程存取它以及存取时注意事项等的说明。

      数或过程存取它以及存取时注意事项等的说明2-12:注释与所描述内容进行同样的缩排注释与所描述内容进行同样的缩排 说明:可使程序排版整齐,并方便注释的阅读与理解 示例:如下例子,排版不整齐,阅读稍感不方便void example_fun( void ){/* code one comments */ CodeBlock One /* code two comments */ CodeBlock Two}              应改为如下布局应改为如下布局void example_fun( void ){ /* code one comments */ CodeBlock One /* code two comments */ CodeBlock Two}21 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-13:将注释与其上面的代码用空行隔开将注释与其上面的代码用空行隔开应如下书写应如下书写/* code one comments */program code one```/* code two comments */program code two示例:如下例子,显得代码过于紧凑。

      示例:如下例子,显得代码过于紧凑/* code one comments */program code one/* code two comments */program code two22 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-14::对对变变量量的的定定义义和和分分支支语语句句((条条件件分分支支、、循循环环语语句句等等))必须编写注释必须编写注释2-15::对对于于switch语语句句下下的的case语语句句,,如如果果因因为为特特殊殊情情况况需需要要处处理理完完一一个个case后后进进入入下下一一个个case处处理理,,必必须须在在该该case语语句句处处理理完完、、下下一一个个case语语句句前前加加上上明明确确的的注注释释说明:这样比较清楚程序编写者的意图,有效防止无故遗漏break语句23 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-1:避免在一行代码或表达式的中间插入注释避免在一行代码或表达式的中间插入注释2-2:通过对函数或过程、变量、结构等:通过对函数或过程、变量、结构等正确的命名正确的命名以及合理以及合理地组织代码的结构,使代码成为地组织代码的结构,使代码成为自注释自注释的。

      的说明:清晰准确的函数、变量等的命名,可增加代码可读性,并减少不必要的注释2-3:在:在代码的代码的功能、意图功能、意图层次上进行注释层次上进行注释,提供有用、额外,提供有用、额外的信息24 C语言编程规范语言编程规范机械工程学院机械工程学院CoME2 注释注释2-4::在在程程序序块块的的结结束束行行右右方方加加注注释释标标记记,,以以表表明明某某程程序序块块的的结束结束2-5:注释格式尽量统一,建议使用:注释格式尽量统一,建议使用“/* …… */”2-6::注注释释应应考考虑虑程程序序易易读读及及外外观观排排版版的的因因素素,,使使用用的的语语言言若若是是中中、、英英兼兼有有的的,,建建议议多多使使用用中中文文,,除除非非能能用用非非常常流流利利准准确的英文表达确的英文表达25 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名26 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名3-1::标标识识符符的的命命名名要要清清晰晰、、明明了了,,有有明明确确含含义义,,同同时时使使用用完完整的单词或大家基本可以理解的缩写,避免使人产生误解。

      整的单词或大家基本可以理解的缩写,避免使人产生误解3-2:命名中:命名中若使用特殊约定或缩写若使用特殊约定或缩写,则,则要有注释说明要有注释说明说明:应该在源文件的开始之处,对文件中所使用的缩写或约定,特殊的缩写,进行必要的注释说明 3-3::自自己己特特有有的的命命名名风风格格,,要要自自始始至至终终保保持持一一致致,,不不可可来来回回变化27 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名3-4::对对于于变变量量命命名名,,禁禁止止取取单单个个字字符符((如如i、、j、、k...)),,建建议议除除了了要要有有具具体体含含义义外外,,还还能能表表明明其其变变量量类类型型、、数数据据类类型型等等,,但但i、、j、、k作局部循环变量是允许的作局部循环变量是允许的3-5::命命名名规规范范必必须须与与所所使使用用的的系系统统风风格格保保持持一一致致,,并并在在同同一一项项目中目中统统一一. .28 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名½3-13-1:除非必要,:除非必要,不要用数字或较奇怪的字符不要用数字或较奇怪的字符来定义标识符。

      来定义标识符½3-23-2::在在同同一一软软件件产产品品内内,,应应规规划划好好接接口口部部分分标标识识符符((变变量量、、结构、函数及常量)的命名,防止编译、链接时产生冲突结构、函数及常量)的命名,防止编译、链接时产生冲突 说明:对接口部分的标识符应该有更严格限制,防止冲突如可规定接口部分的变量与常量之前加上“模块”标识等½ ½ 3-33-3::用用正正确确的的反反义义词词组组命命名名具具有有互互斥斥意意义义的的变变量量或或相相反反动动作的作的函数函数等29 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名说明:下面是一些在软件中常用的反义词组说明:下面是一些在软件中常用的反义词组add / remove begin / end create / destroy insert / delete first / last get / releaseincrement / decrement put / getadd / delete lock / unlock open / closemin / max old / new start / stopnext / previous source / target show / hidesend / receive source / destinationcut / paste up / down示例:示例:int min_sum;int max_sum;int add_user( BYTE *user_name );int delete_user( BYTE *user_name );30 C语言编程规范语言编程规范机械工程学院机械工程学院CoME3 3 标识符命名标识符命名3-4:除了编译:除了编译开关开关/头文件头文件等特殊应用,应等特殊应用,应避免使用避免使用_EXAMPLE_TEST_之类之类以下划线以下划线开始和结尾开始和结尾的定义的定义。

      31 C语言编程规范语言编程规范机械工程学院机械工程学院CoME4 4 可读性可读性32 C语言编程规范语言编程规范机械工程学院机械工程学院CoME4 4 可读性可读性4-1:注意运算符的优先级,:注意运算符的优先级,并用括号并用括号明确表达式的明确表达式的操作顺序操作顺序,避免使用,避免使用默认优先级默认优先级4-2::避免使用不易理解的数字避免使用不易理解的数字,,用有意义的用有意义的标识标识来替代来替代涉及物理状态涉及物理状态或者含有物理意义的常量,不应直接使用数字,必须用有意义的或者含有物理意义的常量,不应直接使用数字,必须用有意义的枚举枚举或宏或宏来代替4-3:源程序中关系较为紧密的代码应尽可能相邻源程序中关系较为紧密的代码应尽可能相邻若按如下形式书写,可能更清晰一些rect.length = 10;rect.width = 5; char_poi = str;说明:便于程序阅读和查找示例:以下代码布局不太合理rect.length = 10;char_poi = str;rect.width = 5;33 C语言编程规范语言编程规范机械工程学院机械工程学院CoME4 4 可读性可读性4-4:不要使用难懂的技巧性很高的语句,除非很有必要时。

      不要使用难懂的技巧性很高的语句,除非很有必要时34 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 变量、结构变量、结构35 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½5-1:去掉没必要的公共变量去掉没必要的公共变量说明:公共变量是增大模块间耦合的原因之一,故应减少没必要的公共变量以降低模块间的耦合度½5-2::仔仔细细定定义义并并明明确确公公共共变变量量的的含含义义、、作作用用、、取取值值范范围及公共变量间的关系围及公共变量间的关系36 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½5-3::明明确确公公共共变变量量与与操操作作此此公公共共变变量量的的函函数数或或过过程程的的关关系系,,如访问、修改及创建等如访问、修改及创建等说明:明确过程操作变量的关系后,将有利于程序的进一步优化、单元测试、系统联调以及代码维护等这种关系的说明可在注释或文档中描述37 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构¹5-4::当当向向公公共共变变量量传传递递数数据据时时,,要要十十分分小小心心,,防防止止赋赋与与不不合合理理的的值值或或越界等现象发生越界等现象发生。

      ¹5-5::防止防止局部变量与公共变量局部变量与公共变量同名同名¹5-6:严禁使用:严禁使用未经初始化未经初始化的变量作为指针的变量作为指针 说明:特别是在C/C++中引用未经赋值的指针,经常会引起系统崩溃½5-1::构构造造仅仅有有一一个个模模块块或或函函数数可可以以修修改改、、创创建建,,而而其其余余有有关关模模块块或或函函数数只只访访问问的的公公共共变变量量,,防防止止多多个个不不同同模模块块或或函函数数都都可可以以修修改改、、创创建建同同一一公公共共变变量量的的现现象 说明:降低公共变量耦合度38 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½5-2::使使用用严严格格形形式式定定义义的的、、可可移移植植的的数数据据类类型型,,尽尽量量不不要要使使用用与与具具体体硬件或软件环境关系密切的硬件或软件环境关系密切的变量变量说明:使用标准的数据类型,有利于程序的移植示例:如下例子(在DOS下BC3.1环境中),在移植时可能产生问题void main(){ register int index; // 寄存器变量 _AX = 0x4000; // _AX是BC3.1提供的寄存器“伪变量” ... // program code}39 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½ 5-3:结构的功能要单一,是针对一种事务的抽象。

      结构的功能要单一,是针对一种事务的抽象说明:结构中的各元素应代表同一事务的不同侧面,而不应把描述没有关系或关系很弱的不同事务的元素放到同一结构中½5-4:不要设计面面俱到、非常灵活的数据结构不要设计面面俱到、非常灵活的数据结构说明:面面俱到、灵活的数据结构反而容易引起误解和操作困难½5-5:不同结构间的关系不要过于复杂不同结构间的关系不要过于复杂说明:若两个结构间关系较复杂、密切,那么应合为一个结构½5-6::结结构构中中元元素素的的个个数数应应适适中中若若结结构构中中元元素素个个数数过过多多可可考考虑虑依依据据某某种原则把元素组成不同的子结构种原则把元素组成不同的子结构,以减少原结构中元素的个数以减少原结构中元素的个数 说明:增加结构的可理解性、可操作性和可维护性40 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½5-7::仔仔细细设设计计结结构构中中元元素素的的布布局局与与排排列列顺顺序序,,使使结结构构容容易易理理解解、、节节省省占用空间,并减少引起误用现象占用空间,并减少引起误用现象½5-8::结结构构的的设设计计要要尽尽量量考考虑虑向向前前兼兼容容和和以以后后的的版版本本升升级级,,并并为为某某些些未未来可能的应用保留余地(如预留一些空间等)。

      来可能的应用保留余地(如预留一些空间等)½5-9::留心具体语言及编译器处理留心具体语言及编译器处理不同数据类型的原则不同数据类型的原则及有关细节及有关细节说明:如在C语言中,static局部变量将在内存“数据区”中生成,而非static局部变量将在“堆栈”中生成这些细节对程序质量的保证非常重要½5-10:编程时,要注意数据类型的:编程时,要注意数据类型的强制转换强制转换说明:当进行数据类型强制转换时,其数据的意义、转换后的取值等都有可能发生变化,而这些细节若考虑不周,就很有可能留下隐患41 C语言编程规范语言编程规范机械工程学院机械工程学院CoME5 5 变量、结构变量、结构½5-11::对对编编译译系系统统默默认认的的数数据据类类型型转转换换,,也也要要有有充充分分的的认认识½5-12:尽量:尽量减少没有必要减少没有必要的数据类型默认转换与强制转换的数据类型默认转换与强制转换½5-13::合合理理地地设设计计数数据据并并使使用用自自定定义义数数据据类类型型,,避避免免数数据据间进行不必要的类型转换间进行不必要的类型转换½5-14::对对自自定定义义数数据据类类型型进进行行恰恰当当命命名名,,使使它它成成为为自自描描述述性性的的,,以以提提高高代代码码可可读读性性。

      注注意意其其命命名名方方式式在在同同一一产产品品中中的统一42 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 函数、过程函数、过程43 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程¹6-1::对所调用函数的错误返回码要仔细、全面地处理对所调用函数的错误返回码要仔细、全面地处理¹6-2:明确函数功能,:明确函数功能,精确精确(而不是近似)地实现函数设计而不是近似)地实现函数设计¹6-3::编编写写可可重重入入函函数数时时,,应应注注意意局局部部变变量量的的使使用用((如如编编写写C/C++语语言言的可重入函数时,应使用的可重入函数时,应使用auto即即缺省态局部变量缺省态局部变量或或寄存器变量寄存器变量)说明:编写C/C++语言的可重入函数时,不应使用static局部变量,否则必须经过特殊处理,才能使函数具有可重入性¹6-4::编编写写可可重重入入函函数数时时,,若若使使用用全全局局变变量量,,则则应应通通过过关关中中断断、、信信号号量量(即(即P、、V操作)操作)等手段对其加以等手段对其加以保护保护说明:若对所使用的全局变量不加以保护,则此函数就不具有可重入性,即当多个进程调用此函数时,很有可能使有关全局变量变为不可知状态。

      44 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程~~示例:假设Exam是int型全局变量,函数Squre_Exam返回Exam平方值那么如下函数不具有可重入性unsigned int example( int para ){ unsigned int temp; Exam = para; // (**) temp = Square_Exam( ); return temp;}此函数若被多个进程调用的话,其结果可能是未知的,因为当(**)语句刚执行完后,另外一个使用本函数的进程可能正好被激活,那么当新激活的进程执行到此函数时,将使Exam赋与另一个不同的para值,所以当控制重新回到“temp = Square_Exam( )”后,计算出的temp很可能不是预想中的结果 45 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程此函数应如下改进unsigned int example( int para ){ unsigned int temp; [申请信号量操作] // 若申请不到“信号量”,说明另外的进程正处于 Exam = para; // 给Exam赋值并计算其平方过程中(即正在使用此 temp = Square_Exam( ); // 信号),本进程必须等待其释放信号后,才可继 [释放信号量操作] // 续执行。

      若申请到信号,则可继续执行,但其 // 它进程必须等待本进程释放信号量后,才能再使 // 用本信号 return temp;}46 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程¹6-5::在在同同一一项项目目组组应应明明确确规规定定对对接接口口函函数数参参数数的的合合法法性性检检查查应应由由函函数数的调用者的调用者负责还是由负责还是由接口函数本身接口函数本身负责,缺省是由负责,缺省是由函数调用者函数调用者负责~~~说明:对于模块间接口函数的参数的合法性检查这一问题,往往有两个极端现象,即:要么是调用者和被调用者对参数均不作合法性检查,结果就遗漏了合法性检查这一必要的处理过程,造成问题隐患;要么就是调用者和被调用者均对参数进行合法性检查,这种情况虽不会造成问题,但产生了冗余代码,降低了效率½ 6-1:防止将函数的参数作为工作变量防止将函数的参数作为工作变量说明:将函数的参数作为工作变量,有可能错误地改变参数内容,所以很危险对必须改变的参数,最好先用局部变量代之,最后再将该局部变量的内容赋给该参数。

      47 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程示例:下函数的实现不太好示例:下函数的实现不太好void sum_data( unsigned int num, int *data, int *sum ){ unsigned int count; *sum = 0; for (count = 0; count < num; count++) { *sum += data[count]; // sum成了工作变量,不太好成了工作变量,不太好 }}若改为如下,则更好些若改为如下,则更好些void sum_data( unsigned int num, int *data, int *sum ){ unsigned int count ; int sum_temp;//在这定义了局部变量在这定义了局部变量 sum_temp = 0; for (count = 0; count < num; count ++) { sum_temp += data[count]; } *sum = sum_temp;}48 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-2:函数的规模尽量限制在:函数的规模尽量限制在200行以内。

      行以内说明:不包括注释和空格行½6-3:一个函数:一个函数仅完成一件功能仅完成一件功能½6-4:为:为简单功能简单功能编写函数编写函数½6-5:不要设计多用途面面俱到的函数不要设计多用途面面俱到的函数说明:多功能集于一身的函数,很可能使函数的理解、测试、维护等变得困难½6-6::函函数数的的功功能能应应该该是是可可以以预预测测的的,,也也就就是是只只要要输输入入数数据据相相同同就就应产生同样的输出应产生同样的输出49 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程... // 程序代码proc Print_Msg // 过程(函数)Print_Msg ... // 程序代码 jmp LABEL ... // 程序代码endpproc Input_Msg // 过程(函数)Input_Msg ... // 程序代码LABEL: ... // 程序代码endp½6-7:尽量不要编写依赖于其他函数内部实现的函数尽量不要编写依赖于其他函数内部实现的函数说明:此条为函数独立性的基本要求由于目前大部分高级语言都是结构化的,所以通过具体语言的语法要求与编译器功能,基本就可以防止这种情况发生。

      但在汇编语言中,由于其灵活性,很可能使函数出现这种情况 示例:左边是在DOS下TASM的汇编程序例子过程Print_Msg的实现依赖于Input_Msg的具体实现,这种程序是非结构化的,难以维护、修改50 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-8::避免设计多参数函数避免设计多参数函数,不使用的参数从接口中去掉不使用的参数从接口中去掉说明:目的减少函数间接口的复杂度½6-9::非调度函数非调度函数应减少或防止控制参数,应减少或防止控制参数,尽量只使用数据参数尽量只使用数据参数~~说明:本建议目的是防止函数间的控制耦合调度函数是指根据输入的消息类型或控制命令,来启动相应的功能实体(即函数或过程),而本身并不完成具体功能控制参数是指改变函数功能行为的参数,即函数要根据此参数来决定具体怎样工作非调度函数的控制参数增加了函数间的控制耦合,很可能使函数间的耦合度增大,并使函数的功能不唯一51 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-10:检查函数所有参数输入的有效性检查函数所有参数输入的有效性。

      ½6-11::检检查查函函数数所所有有非非参参数数输输入入的的有有效效性性,,如如数数据据文文件件、、公共变量等公共变量等说明:函数的输入主要有两种:一种是参数输入;另一种是全局变量、数据文件的输入,即非参数输入函数在使用输入之前,应进行必要的检查½6-12::函数名应准确描述函数的功能函数名应准确描述函数的功能52 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-13::使使用用动动宾宾词词组组为为执执行行某某操操作作的的函函数数命命名名如如果果是是OOP方方法法,,可可以以只只有有动词(名词是对象本身)动词(名词是对象本身)示例:参照如下方式命名函数void print_record( unsigned int rec_ind ) ;int input_record( void ) ;unsigned char get_current_color( void ) ;½建议建议6-14:避免使用:避免使用无意义或含义不清无意义或含义不清的的动词动词为函数命名为函数命名½建议建议6-15:函数的:函数的返回值返回值要要清楚、明了清楚、明了,让使用者不容易忽视错误情况,让使用者不容易忽视错误情况½6-16::除除非非必必要要,,最最好好不不要要把把与与函函数数返返回回值值类类型型不不同同的的变变量量,,以以编编译译系系统统默认的转换方式或强制的转换方式作为返回值返回。

      默认的转换方式或强制的转换方式作为返回值返回½6-17:让函数在:让函数在调用点调用点显得显得易懂、容易理解易懂、容易理解53 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-18::在在调调用用函函数数填填写写参参数数时时,,应应尽尽量量减减少少没没有有必必要要的的默默认认数数据据类类型型转转换换或或强强制制数数据类型转换据类型转换说明:因为数据类型转换或多或少存在危险½6-19:避免函数中不必要语句:避免函数中不必要语句,防止程序中的垃圾代码,防止程序中的垃圾代码说明:程序中的垃圾代码不仅占用额外的空间,而且还常常影响程序的功能与性能,很可能给程序的测试、维护等造成不必要的麻烦½6-20::防止把没有关联的语句放到一个函数中防止把没有关联的语句放到一个函数中说明:防止函数或过程内出现随机内聚随机内聚是指将没有关联或关联很弱的语句放到同一个函数或过程中随机内聚给函数或过程的维护、测试及以后的升级等造成了不便,同时也使函数或过程的功能不明确 54 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-21::如如果果多多段段代代码码重重复复做做同同一一件件事事情情,,那那么么在在函函数数的的划划分分上上可可能能存存在在问题。

      问题说明:若此段代码各语句之间有实质性关联并且是完成同一件功能的,那么可考虑把此段代码构造成一个新的函数½6-22::功功能能不不明明确确\较较小小的的函函数数,,特特别别是是仅仅有有一一个个上上级级函函数数调调用用它它时时,,应应考虑考虑把它合并到上级函数把它合并到上级函数中,而不必单独中,而不必单独存在½6-23:设计高扇入、合理扇出(小于:设计高扇入、合理扇出(小于7)的函数说明:(扇出是指一个函数直接调用(控制)其它函数的数目,而扇入是指有多少上级函数调用它). 扇出过大,表明函数过分复杂,需要控制和协调过多的下级函数;而扇出过小,如总是1,表明函数的调用层次可能过多,这样不利程序阅读和函数结构的分析,并且程序运行时会对系统资源如堆栈空间等造成压力函数较合理的扇出(调度函数除外)通常是3-555 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-24:减少函数本身或函数间的递归调用减少函数本身或函数间的递归调用说明:递归调用特别是函数间的递归调用(如A->B->C->A),影响程序的可理解性;递归调用一般都占用较多的系统资源(如栈空间);递归调用对程序的测试有一定影响。

      故除非为某些算法或功能的实现方便,应减少没必要的递归调用½6-25::仔仔细细分分析析模模块块的的功功能能及及性性能能需需求求,,并并进进一一步步细细分分,,同同时时若若有有必要必要画出有关数据流图画出有关数据流图,据此来进行模块的函数划分与组织据此来进行模块的函数划分与组织说明:函数的划分与组织是模块的实现过程中很关键的步骤,如何划分出合理的函数结构,关系到模块的最终效率和可维护性、可测性等根据模块的功能图或数据流图映射出函数结构是常用方法之一56 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-26::改改进进模模块块中中函函数数的的结结构构,,降降低低函函数数间间的的耦耦合合度度,,并并提提高高函函数数的的独独立立性性以以及及代代码码可可读读性性、、效效率率和和可可维维护护性性优优化化函函数数结结构构时时,,要要遵遵守守以以下下原则:原则:((1)不能影响模块)不能影响模块功能的实现功能的实现2)仔细考查)仔细考查模块模块或或函数出错处理函数出错处理及模块的性能要求并进行完善及模块的性能要求并进行完善3)通过)通过分解或合并分解或合并函数来函数来改进软件结构改进软件结构。

      4)考查函数的)考查函数的规模,过大的要进行分解规模,过大的要进行分解5))降低函数间接口的复杂度降低函数间接口的复杂度6)不同层次的函数调用要有)不同层次的函数调用要有较合理的扇入、扇出较合理的扇入、扇出7)函数功能应可预测函数功能应可预测8)提高函数)提高函数内聚内聚单一功能的函数内聚最高)单一功能的函数内聚最高)说明:对初步划分后的函数结构应进行改进、优化,使之更为合理57 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-27:在多任务操作系统的环境下编程,要:在多任务操作系统的环境下编程,要注意函数可重入性的构造注意函数可重入性的构造说明:可重入性是指函数可以被多个任务进程调用{在多任务操作系统中,函数是否具有可重入性是非常重要的,因为这是多个进程可以共用此函数的必要条件另外,编译器是否提供可重入函数库,与它所服务的操作系统有关,只有操作系统是多任务时,编译器才有可能提供可重入函数库如DOS下BC和MSC等就不具备可重入函数库,因为DOS是单用户单任务操作系统)}½6-28:避免使用:避免使用BOOL参数C语言中没有语言中没有BOOL)说明:原因有二,其一是BOOL参数值无意义,TURE/FALSE的含义是非常模糊的,在调用时很难知道该参数到底传达的是什么意思;其二是BOOL参数值不利于扩充。

      还有NULL也是一个无意义的单词58 C语言编程规范语言编程规范机械工程学院机械工程学院CoME6 6 函数、过程函数、过程½6-29:: 对于对于提供了返回值的函数提供了返回值的函数,在引用时最好,在引用时最好使用其返回值使用其返回值½6-30::当当一一个个过过程程((函函数数))中中对对较较长长变变量量((一一般般是是结结构构的的成成员员))有有较较多多引用引用时,可以时,可以用一个意义相当的用一个意义相当的宏宏代替代替 说明:这样可以增加编程效率和程序的可读性示例:在某过程中较多引用TheReceiveBuffer[FirstSocket].byDataPtr,则可以通过以下宏定义来代替:# define pSOCKDATA TheReceiveBuffer[FirstScoket].byDataPtr59 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 可测性可测性60 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-1::在在同同一一项项目目组组或或产产品品组组内内,,要要有有一一套套统统一一的的为为集集成成测测试试与与系系统统联联调准备的调准备的调测开关调测开关及相应打印函数,并且要有详细的说明。

      及相应打印函数,并且要有详细的说明说明:本规则是针对项目组或产品组的¹7-2::在在同同一一项项目目组组或或产产品品组组内内,,调调测测打打印印出出的的信信息息串串的的格格式式要要有有统统一一的形式信息串中至少要有所在模块名(或源文件名)及行号信息串中至少要有所在模块名(或源文件名)及行号说明:统一的调测信息格式便于集成测试¹7-3::编编程程的的同同时时要要为为单单元元测测试试选选择择恰恰当当的的测测试试点点,,并并仔仔细细构构造造测测试试代代码码、、测测试试用用例例,,同同时时给给出出明明确确的的注注释释说说明明测测试试代代码码部部分分应应作作为为((模模块块中中的的))一一个个子子模模块块,,以以方方便便测测试试代代码码在在模模块块中中的的安安装装与与拆拆卸卸((通通过过调测开关)调测开关)说明:为单元测试而准备61 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-4::在在进进行行集集成成测测试试/系系统统联联调调之之前前,,要要构构造造好好测测试试环环境境、、测测试试项项目目及测试用例,同时仔细及测试用例,同时仔细分析并优化分析并优化测试用例,以提高测试效率。

      测试用例,以提高测试效率说明:好的测试用例应尽可能模拟出程序所遇到的边界值、各种复杂环境及一些极端情况等¹7-5::使用断言使用断言来发现软件问题,提高代码可测性来发现软件问题,提高代码可测性说明:断言是对某种假设条件进行检查(可理解为若条件成立则无动作,否则应报告),它可以快速发现并定位软件问题,同时对系统错误进行自动报警断言可以对在系统中隐藏很深,用其它手段极难发现的问题进行定位,从而缩短软件问题定位时间,提高系统的可测性实际应用时,可根据具体情况灵活地设计断言62 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性示例:下面是示例:下面是C语言中的一个断言,用语言中的一个断言,用宏宏来设计的其中来设计的其中NULL为为0L))#ifdef _EXAM_ASSERT_TEST_ // 若使用断言测试若使用断言测试void exam_assert( char * file_name, unsigned int line_no ){ printf( "\n[EXAM]Assert failed: %s, line %u\n", file_name, line_no ); abort( );}#define EXAM_ASSERT( condition ) if (condition) // 若条件成立,则无动作若条件成立,则无动作 NULL; else // 否则报告否则报告 exam_assert( __FILE__, __LINE__ ) #else // 若不使用断言测试若不使用断言测试#define EXAM_ASSERT(condition) NULL #endif /* end of ASSERT */63 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-6::用用断断言言来来检检查查程程序序正正常常运运行行时时不不应应发发生生但但在在调调测测时时有有可可能能发发生生的非法情况。

      的非法情况¹7-7:不能用断言来检查最终产品:不能用断言来检查最终产品肯定会出现且必须处理的错误肯定会出现且必须处理的错误情况说明:断言是用来处理不应该发生的错误情况的,对于可能会发生的且必须处理的情况要写防错程序,而不是断言如某模块收到其它模块或链路上的消息后,要对消息的合理性进行检查,此过程为正常的错误检查,不能用断言来实现¹7-8:对较复杂的断言加上明确的注释对较复杂的断言加上明确的注释说明:为复杂的断言加注释,可澄清断言含义并减少不必要的误用64 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-9:用:用断言断言确认函数的参数确认函数的参数示例:假设某函数参数中有一个指针,那么使用指针前可对它检示例:假设某函数参数中有一个指针,那么使用指针前可对它检查,如下查,如下int exam_fun( unsigned char *str ){ EXAM_ASSERT( str != NULL ); // 用断言检查“假设指针不为空”这个条件 ... //other program code}65 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-10:用断言:用断言保证保证没有定义没有定义的特性或功能不被使用。

      的特性或功能不被使用示例:假设某通信模块在设计时,准备提供“无连接”和“连接” 这两种业务但当前的版本中仅实现了“无连接”业务,且在此版本的正式发行版中,用户(上层模块)不应产生“连接”业务的请求,那么在测试时可用断言检查用户是否使用“连接”业务define EXAM_CONNECTIONLESS 0 // 无连接业务无连接业务#define EXAM_CONNECTION 1 // 连接业务连接业务int msg_process( EXAM_MESSAGE *msg ){ unsigned char service; /* message service class */ EXAM_ASSERT( msg != NULL );service = get_msg_service_class( msg ); EXAM_ASSERT( service != EXAM_CONNECTION ); // 假设不使用连接业务假设不使用连接业务 ... //other program code}66 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-11::用用断断言言对对程程序序开开发发环环境境((OS/Compiler/Hardware))的的假假设设进行检查。

      进行检查说明:程序运行时所需的软硬件环境及配置要求,不能用断言来检查,而必须由一段专门代码处理用断言仅可对程序开发环境中的假设及所配置的某版本软硬件是否具有某种功能的假设进行检查如某网卡是否在系统运行环境中配置了,应由程序中正式代码来检查;而此网卡是否具有某设想的功能,则可由断言来检查对编译器提供的功能及特性假设可用断言检查,原因是软件最终产品(即运行代码或机器码)与编译器已没有任何直接关系,即软件运行过程中(注意不是编译过程中)不会也不应该对编译器的功能提出任何需求示例:用断言检查编译器的int型数据占用的内存空间是否为2,如下EXAM_ASSERT( sizeof( int ) == 2 );¹7-12::正正式式软软件件产产品品中中应应把把断断言言及及其其它它调调测测代代码码去去掉掉((即即把把有有关关的的调调测开关关掉)测开关关掉)说明:加快软件运行速度67 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性¹7-13::在在软软件件系系统统中中设设置置与与取取消消有有关关测测试试手手段段,,不不能能对对软软件件实实现现的的功能等产生影响功能等产生影响。

      说明:即有测试代码的软件和关掉测试代码的软件,在功能行为上应一致¹7-14::用用调调测测开开关关来来切切换换软软件件的的DEBUG版版和和正正式式版版,,而而不不要要同同时时存存在正式版本和在正式版本和DEBUG版本的不同源文件,以减少维护的难度版本的不同源文件,以减少维护的难度¹7-15::软软件件的的DEBUG版版本本和和发发行行版版本本应应该该统统一一维维护护,,不不允允许许分分家家,,并且要时刻注意保证两个版本在实现功能上的一致性并且要时刻注意保证两个版本在实现功能上的一致性68 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性½7-1::在在编编写写代代码码之之前前,,应应预预先先设设计计好好程程序序调调试试与与测测试试的的方方法法和和手手段段,,并设计好各种调测开关及相应测试代码如打印函数并设计好各种调测开关及相应测试代码如打印函数等说明:程序的调试与测试是软件生存周期中很重要的一个阶段,如何对软件进行较全面、高率的测试并尽可能地找出软件中的错误就成为很关键的问题因此在编写源代码之前,除了要有一套比较完善的测试计划外,还应设计出一系列代码测试手段,为单元测试、集成测试及系统联调提供方便。

      ½7-2:调测开关应分为不同级别和类型调测开关应分为不同级别和类型说明:调测开关的设置及分类应从以下几方面考虑:针对模块或系统某部分代码的调测;针对模块或系统某功能的调测;出于某种其它目的,如对性能、容量等的测试这样做便于软件功能的调测,并且便于模块的单元测试、系统联调等69 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性½7-3:编写防错程序,然后在处理错误之后可用断言宣布发生错误编写防错程序,然后在处理错误之后可用断言宣布发生错误示例:假如某模块收到通信链路上的消息,则应对消息的合法性进行检查,若消息类别不是通信协议中规定的,则应进行出错处理,之后可用断言报告,如下例70 C语言编程规范语言编程规范机械工程学院机械工程学院CoME7 7 可测性可测性#ifdef _EXAM_ASSERT_TEST_ // 若使用断言测试若使用断言测试/* Notice: this function does not call 'abort' to exit program */void assert_report( char * file_name, unsigned int line_no ){    printf( "\n[EXAM]Error Report: %s, line %u\n",             file_name, line_no );}#define  ASSERT_REPORT( condition )     if ( condition ) // 若条件成立,则无动作若条件成立,则无动作        NULL;    else // 否则报告否则报告        assert_report ( __FILE__, __LINE__ ) #else // 若不使用断言测试若不使用断言测试#define ASSERT_REPORT( condition )  NULL #endif /* end of ASSERT */int msg_handle( unsigned char msg_name, unsigned char * msg ){    switch( msg_name )    {        case MSG_ONE:            ... // 消息消息MSG_ONE处理处理            return MSG_HANDLE_SUCCESS;                ... // 其它合法消息处理其它合法消息处理            default:            ... // 消息出错处理消息出错处理            ASSERT_REPORT( FALSE );  // “合法合法”消息不成立,报告消息不成立,报告            return MSG_HANDLE_ERROR;    }} 71 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 程序效率程序效率72 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率¹8-1:编程时要经常注意代码的效率。

      编程时要经常注意代码的效率说明:代码效率分为全局效率、局部效率、时间效率及空间效率全局效率是站在整个系统的角度上的系统效率;局部效率是站在模块或函数角度上的效率;时间效率是程序处理输入任务所需的时间长短;空间效率是程序所需内存空间,如机器代码空间大小、数据空间大小、栈空间大小等¹8-2::在在保保证证软软件件系系统统的的正正确确性性、、稳稳定定性性、、可可读读性性及及可可测测性性的的前前提提下下,,提高代码效率提高代码效率说明:不能一味地追求代码效率,而对软件的正确性、稳定性、可读性及可测性造成影响¹8-3::局局部部效效率率应应为为全全局局效效率率服服务务,,不不能能因因为为提提高高局局部部效效率率而而对对全全局局效效率造成影响率造成影响73 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率¹8-4::通通过过对对系系统统数数据据结结构构的的划划分分与与组组织织的的改改进进,,以以及及对对程程序序算算法法的的优优化化来提高空间效率来提高空间效率说明:这种方式是解决软件空间效率的根本办法typedef struct STUDENT_STRU{ BYTE name[8]; BYTE age; BYTE sex; BYTE class;} STUDENT;typedef struct STUDENT_SCORE_STRU{ WORD student_index; BYTE subject; float score;} STUDENT_SCORE;示例:如下记录学生学习成绩的结构不合理。

      typedef unsigned char BYTE;typedef unsigned short WORD;typedef struct STUDENT_SCORE_STRU{ BYTE name[8]; BYTE age; BYTE sex; BYTE class; BYTE subject; float score;} STUDENT_SCORE;因为每位学生都有多科学习成绩,故如上结构将占用较大空间应如下改进(分为两个结构),总的存贮空间将变小,操作也变得更方便74 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率¹8-5:循环体内工作量最小化循环体内工作量最小化说明:应仔细考虑循环体内的语句是否可以放在循环体之外,使循环体内工作量最小,从而提高程序的时间效率示例:如下代码效率不高for (ind = 0; ind < MAX_ADD_NUMBER; ind++){ sum += ind; back_sum = sum; /* backup sum */}语句“back_sum = sum;”完全可以放在for语句之后,如下。

      for (ind = 0; ind < MAX_ADD_NUMBER; ind++){ sum += ind;}back_sum = sum; /* backup sum */75 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率½8-1:仔细分析有关算法,并进行:仔细分析有关算法,并进行优化优化½8-2::仔仔细细考考查查、、分分析析系系统统及及模模块块处处理理输输入入((如如事事务务、、消消息息等等))的的方方式式,,并加以改进并加以改进½8-3::对对模模块块中中函函数数的的划划分分及及组组织织方方式式进进行行分分析析、、优优化化,,改改进进模模块块中中函函数数的组织结构,提高程序效率的组织结构,提高程序效率说明:软件系统的效率主要与算法、处理任务方式、系统功能及函数结构有很大关系,仅在代码上下功夫一般不能解决根本问题½8-4:编程时,要随时留心代码效率;优化代码时,要考虑周全编程时,要随时留心代码效率;优化代码时,要考虑周全½8-5:不应花过多的时间拼命地提高:不应花过多的时间拼命地提高调用不很频繁调用不很频繁的函数代码效率的函数代码效率。

      说明:对代码优化可提高效率,但若考虑不周很有可能引起严重后果76 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率½8-6:要仔细地构造或直接用汇编编写调用:要仔细地构造或直接用汇编编写调用频繁或性能要求极高频繁或性能要求极高的函数½8-7::在在保保证证程程序序质质量量的的前前提提下下,,通通过过压压缩缩代代码码量量、、去去掉掉不不必必要要代代码码以以及及减少不必要的局部和全局变量减少不必要的局部和全局变量,,来提高空间效率来提高空间效率说明:这种方式对提高空间效率可起到一定作用,但往往不能解决根本问题½8-8:在多重循环中,应将:在多重循环中,应将最忙的循环放在最内层最忙的循环放在最内层½8-9:尽量:尽量减少循环嵌套层次减少循环嵌套层次77 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率½8-10::避免循环体内含避免循环体内含判断语句判断语句,应将循环语句置于判断语句的代码块之中,应将循环语句置于判断语句的代码块之中说明:目的是减少判断次数一般情况,与循环变量无关的判断语句可以移到循环体外,而有关的则不可以因为判断语句与循环变量无关,故可如下改进,以减少判断次数。

      if (data_type == RECT_AREA){ for (ind = 0; ind < MAX_RECT_NUMBER; ind++) { area_sum += rect_area[ind]; }}else{ for (ind = 0; ind < MAX_RECT_NUMBER; ind++) { rect_length_sum += rect[ind].length; rect_width_sum += rect[ind].width; }}示例:如下代码效率稍低for (ind = 0; ind < MAX_RECT_NUMBER; ind++){ if (data_type == RECT_AREA) { area_sum += rect_area[ind]; } else { rect_length_sum += rect[ind].length; rect_width_sum += rect[ind].width; }}78 C语言编程规范语言编程规范机械工程学院机械工程学院CoME8 8 程序效率程序效率½8-11:尽量用:尽量用乘法乘法或其它方法或其它方法代替代替除法除法,特别是浮点运算中的除法。

      特别是浮点运算中的除法说明:浮点运算除法要占用较多CPU资源示例:如下表达式运算可能要占较多CPU资源define PAI 3.1416radius = circle_length / (2 * PAI);应如下把浮点除法改为浮点乘法define PAI_RECIPROCAL (1 / 3.1416 ) // 编译器编译时,将生成具体浮点数radius = circle_length * PAI_RECIPROCAL / 2; ½ 8-12:不要一味追求紧凑的代码不要一味追求紧凑的代码说明:因为紧凑的代码并不代表高效的机器码 79 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证80 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-1:在软件:在软件设计过程中设计过程中构筑软件质量构筑软件质量½9-2:代码质量保证优先原则:代码质量保证优先原则     ((1)正确性,指程序要实现设计要求的功能正确性,指程序要实现设计要求的功能     ((2)稳定性、安全性,指程序稳定、可靠、安全稳定性、安全性,指程序稳定、可靠、安全。

           ((3)可测试性,指程序要具有良好的可测试性可测试性,指程序要具有良好的可测试性     ((4)规范)规范/可读性,指程序书写风格、命名规则等要符合规范可读性,指程序书写风格、命名规则等要符合规范     ((5)全局效率,指软件系统的整体效率全局效率,指软件系统的整体效率     ((6)局部效率,指某个模块)局部效率,指某个模块/子模块子模块/函数的本身效率函数的本身效率     ((7)个人表达方式)个人表达方式/个人方便性,指个人编程习惯个人方便性,指个人编程习惯81 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-3:只引用:只引用属于自己的属于自己的存贮空间存贮空间说明:若模块封装的较好,那么一般不会发生非法引用他人的空间½9-4:防止引用:防止引用已经释放已经释放的内存空间的内存空间说明:在实际编程过程中,稍不留心就会出现在一个模块中释放了某个内存块(如C语言指针),而另一模块在随后的某个时刻又使用了它要防止这种情况发生½9-5:过程:过程/函数中分配的内存,在过程函数中分配的内存,在过程/函数退出之前要释放函数退出之前要释放。

      82 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-6::过过程程/函函数数中中申申请请的的((为为打打开开文文件件而而使使用用的的))文文件件句句柄柄,,在在过过程程/函函数退出之前要关闭数退出之前要关闭说明:分配的内存不释放以及文件句柄不关闭,是较常见的错误,而且稍不注意就有可能发生这类错误往往会引起很严重后果,且难以定位示例:下函数在退出之前,没有把分配的内存释放83 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证应改为如下应改为如下int example_fun( BYTE gt_len, BYTE *gt_code ){    BYTE *gt_buf;    gt_buf = (BYTE * ) malloc ( MAX_GT_LENGTH );    ...  // program code, include check gt_buf if or not NULL.        /* global title length error */    if (gt_len > MAX_GT_LENGTH)    {        free( gt_buf  ); // 退出之前释放退出之前释放gt_buf        return GT_LENGTH_ERROR;      }        ...  // other program code}typedef unsigned char BYTE;int example_fun( BYTE gt_len, BYTE *gt_code ){ BYTE *gt_buf; gt_buf = (BYTE *) malloc (MAX_GT_LENGTH); ... //program code, include check gt_buf if or not NULL. /* global title length error */ if (gt_len > MAX_GT_LENGTH) { return GT_LENGTH_ERROR; // 忘了释放忘了释放gt_buf } ... // other program code}84 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证¹9-7:防止:防止内存操作越界内存操作越界。

      说明:内存操作主要是指对数组、指针、内存地址等的操作内存操作越界是软件系统主要错误之一,后果往往非常严重,所以当我们进行这些操作时一定要仔细小心示例:假设某软件系统最多可由10个用户同时使用,用户号为1-10,那么如下程序存在问题define MAX_USR_NUM 10unsigned char usr_login_flg[MAX_USR_NUM]= "";void set_usr_login_flg( unsigned char usr_no ){ if (!usr_login_flg[usr_no]) { usr_login_flg[usr_no]= TRUE; }}void set_usr_login_flg( unsigned char usr_no ){ if (!usr_login_flg[usr_no - 1]) { usr_login_flg[usr_no - 1]= TRUE; }}当usr_no为10时,将使用usr_login_flg越界可采用如下方式解决85 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证¹9-8:认真处理程序所能遇到的各种出错情况。

      认真处理程序所能遇到的各种出错情况¹9-9::系系统统运运行行之之初初,,要要初初始始化化有有关关变变量量及及运运行行环环境境,,防防止止未未经经初初始化的变量被引用始化的变量被引用¹9-10:系统运行之初,要对:系统运行之初,要对加载到系统中的数据进行一致性检查加载到系统中的数据进行一致性检查说明:使用不一致的数据,容易使系统进入混乱状态和不可知状态¹9-11::严禁随意更改其它模块或系统的有关设置和配置严禁随意更改其它模块或系统的有关设置和配置说明:编程时,不能随心所欲地更改不属于自己模块的有关设置如常量、数组的大小等86 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证¹9-12:不能随意改变与其它模块的接口不能随意改变与其它模块的接口¹9-13:充分了解:充分了解系统的接口系统的接口之后,再使用系统提供的功能之后,再使用系统提供的功能~~示例:在B型机的各模块与操作系统的接口函数中,有一个要由各模块负责编写的初始化过程,此过程在软件系统加载完成后,由操作系统发送的初始化消息来调度因此就涉及到初始化消息的类型与消息发送的顺序问题,特别是消息顺序,若没搞清楚就开始编程,很容易引起严重后果。

      以下示例引自B型曾出现过的实际代码,其中使用了FID_FETCH_DATA与FID_INITIAL初始化消息类型,注意B型机的系统是在FID_FETCH_DATA之前发送FID_INITIAL的87 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证MID alarm_module_list[MAX_ALARM_MID];int FAR SYS_ALARM_proc( FID function_id, int handle ){ _UI i, j; switch ( function_id ) { ... // program code case FID_INITAIL: for (i = 0; i < MAX_ALARM_MID; i++) { if (alarm_module_list[i]== BAM_MODULE // **)) || (alarm_module_list[i]== LOCAL_MODULE) { for (j = 0; j < ALARM_CLASS_SUM; j++) { FAR_MALLOC( ... ); 88 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证 } } } ... // program code break; case FID_FETCH_DATA: ... // program code Get_Alarm_Module( ); // 初始化初始化alarm_module_list break; ... // program code }} 89 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证由于FID_INITIAL是在FID_FETCH_DATA之前执行的,而初始化alarm_module_list是在FID_FETCH_DATA中进行的,故在FID_INITIAL中(**)处引用alarm_module_list变量时,它还没有被初始化。

      这是个严重错误应如下改正:要么把Get_Alarm_Module函数放在FID_INITIAL中(**)之前;要么就必须考虑(**)处的判断语句是否可以用(不使用alarm_module_list变量的)其它方式替代,或者是否可以取消此判断语句¹ 9-14:编程时,要防止差:编程时,要防止差1错误说明:此类错误一般是由于把“<=”误写成“<”或“>=”误写成“>”等造成的,由此引起的后果,很多情况下是很严重的,所以编程时,一定要在这些地方小心当编完程序后,应对这些操作符进行彻底检查90 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证¹9-15::要要时时刻刻注注意意易易混混淆淆的的操操作作符符当当编编完完程程序序后后,,应应从从头头至至尾尾检查一遍这些操作符,以防止拼写错误检查一遍这些操作符,以防止拼写错误说明:形式相近的操作符最容易引起误用,如C/C++中的“=”与“==”、“|”与“||”、“&”与“&&”等,若拼写错了,编译器不一定能够检查出来91 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证¹9-16::有有可可能能的的话话,,if语语句句尽尽量量加加上上else分分支支,,对对没没有有else分分支的语句要小心对待;支的语句要小心对待;switch语句必须有语句必须有default分支分支。

      ¹~~9-17::Unix下下,,多多线线程程的的中中的的子子线线程程退退出出必必需需采采用用主主动动退退出出方式,即子线程应方式,即子线程应return出口出口¹9-18:不要滥用:不要滥用goto语句说明:goto语句会破坏程序的结构性,所以除非确实需要,最好不使用goto语句½9-1::不不使使用用与与硬硬件件或或操操作作系系统统关关系系很很大大的的语语句句,,而而使使用用建建议议的的标标准语句,以提高软件的可移植性和可重用性准语句,以提高软件的可移植性和可重用性92 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-2:除非为了满足特殊需求,:除非为了满足特殊需求,避免使用避免使用嵌入式汇编嵌入式汇编说明:程序中嵌入式汇编,一般都对可移植性有较大的影响½9-3::精精心心地地构构造造、、划划分分子子模模块块,,并并按按“接接口口”部部分分及及“内内核核”部部分分合合理地组织子模块,以提高理地组织子模块,以提高“内核内核”部分的可移植性和可重用性部分的可移植性和可重用性说明:对不同产品中的某个功能相同的模块,若能做到其内核部分完全或基本一致,那么无论对产品的测试、维护,还是对以后产品的升级都会有很大帮助。

      ½9-4:精心构造算法,并对其性能、效率进行测试精心构造算法,并对其性能、效率进行测试½9-5::对较关键的算法最好对较关键的算法最好使用其它算法来确认使用其它算法来确认93 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-6:时刻时刻注意表达式是否会上溢、下溢注意表达式是否会上溢、下溢示例:如下程序将造成变量下溢示例:如下程序将造成变量下溢unsigned char size ;while (size-- >= 0) // 将出现下溢将出现下溢{ ... // program code}当当size等于等于0时,再减时,再减1不会小于不会小于0,而是,而是0xFF,故程序是一个死循环应如下修改故程序是一个死循环应如下修改signed char size; // 从从unsigned char 改为改为signed charwhile (size-- >= 0){ ... // program code}94 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-7::使用变量时要注意其使用变量时要注意其边界值边界值的情况的情况。

      示例:如C语言中字符型变量,有效值范围为-128到1279-8:留心程序:留心程序机器码大小机器码大小(如指令空间大小、数据空间大小、堆栈空间大(如指令空间大小、数据空间大小、堆栈空间大小等)是否超出系统有关限制小等)是否超出系统有关限制½9-9::为为用用户户提提供供良良好好的的接接口口界界面面,,使使用用户户能能较较充充分分地地了了解解系系统统内内部部运运行行状态及有关系统出错情况状态及有关系统出错情况½9-10::系系统统应应具具有有一一定定的的容容错错能能力力,,对对一一些些错错误误事事件件((如如用用户户误误操操作作等等))能进行自动补救能进行自动补救95 C语言编程规范语言编程规范机械工程学院机械工程学院CoME9 9 质量保证质量保证½9-11::对对一一些些具具有有危危险险性性的的操操作作代代码码((如如写写硬硬盘盘、、删删数数据据等等))要要仔仔细细考考虑虑,,防止对数据、硬件等的安全构成危害,以提高系统的安全性防止对数据、硬件等的安全构成危害,以提高系统的安全性½~~9-12:使用第三方提供的软件开发工具包或控件时,要注意以下几点::使用第三方提供的软件开发工具包或控件时,要注意以下几点:((1)充分了解应用接口、使用环境及使用时注意事项。

      充分了解应用接口、使用环境及使用时注意事项2)不能过分相信其正确性不能过分相信其正确性3)除非必要,不要使用不熟悉的第三方工具包与控件除非必要,不要使用不熟悉的第三方工具包与控件说明:使用工具包与控件,可加快程序开发速度,节省时间,但使用之前一定对它有较充分的了解,同时第三方工具包与控件也有可能存在问题½~~9-13:资源文件(多语言版本支持),如果资源是对语言敏感的,应让该:资源文件(多语言版本支持),如果资源是对语言敏感的,应让该资源与源代码文件脱离,具体方法有下面几种:使用单独的资源文件、资源与源代码文件脱离,具体方法有下面几种:使用单独的资源文件、DLL文件或其它单独的描述文件(如数据库格式)文件或其它单独的描述文件(如数据库格式)96 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 代码编辑、编译、审查代码编辑、编译、审查97 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 10 代码编辑、编译、审查代码编辑、编译、审查¹10-1:打开编译器的所有:打开编译器的所有告警开关告警开关对程序进行编译对程序进行编译¹10-2:在产品软件(项目组)中,要:在产品软件(项目组)中,要统一编译开关统一编译开关选项。

      选项¹10-3:通过:通过代码走读代码走读及及审查方式审查方式对代码进行检查对代码进行检查说明:代码走读主要是对程序的编程风格如注释、命名等以及编程时易出错的内容进行检查,可由开发人员自己或开发人员交叉的方式进行;代码审查主要是对程序实现的功能及程序的稳定性、安全性、可靠性等进行检查及评审,可通过自审、交叉审核或指定部门抽查等方式进行98 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 10 代码编辑、编译、审查代码编辑、编译、审查½10-1::同同产产品品软软件件((项项目目组组))内内,,最最好好使使用用相相同同的的编编辑辑器器,,并并使使用用相相同同的设置选项的设置选项说明:同一项目组最好采用相同的智能语言编辑器,如Muiti Editor,Visual Editor(我使用Ultra Editor,ilan2003)等,并设计、使用一套缩进宏及注释宏等,将缩进等问题交由编辑器处理½10-2:要:要小心地使用小心地使用编辑器提供的编辑器提供的块拷贝功能编程块拷贝功能编程说明:当某段代码与另一段代码的处理功能相似时,许多开发人员都用编辑器提供的块拷贝功能来完成这段代码的编写。

      由于程序功能相近,故所使用的变量、采用的表达式等在功能及命名上可能都很相近,所以使用块拷贝时要注意,除了修改相应的程序外,一定要把使用的每个变量仔细查看一遍,以改成正确的不应指望编译器能查出所有这种错误,比如当使用的是全局变量时,就有可能使某种错误隐藏下来99 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 10 代码编辑、编译、审查代码编辑、编译、审查½10-3::合理地设计软件系统目录合理地设计软件系统目录,方便开发人员使用方便开发人员使用说明:方便、合理的软件系统目录,可提高工作效率目录构造的原则是方便有关源程序的存储、查询、编译、链接等工作,同时目录中还应具有工作目录----所有的编译、链接等工作应在此目录中进行,工具目录----有关文件编辑器、文件查找等工具可存放在此目录中100 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 10 代码编辑、编译、审查代码编辑、编译、审查½10-4::某某些些语语句句经经编编译译后后产产生生告告警警,,但但如如果果你你认认为为它它是是正正确确的的,,那那么么应应通过某种手段去掉告警信息通过某种手段去掉告警信息。

      ~~说明:在Borland C/C++中,可用“#pragma warn”来关掉或打开某些告警示例:#pragma warn -rvl // 关闭告警int examples_fun( void ){ // 程序,但无return语句}#pragma warn +rvl // 打开告警编译函数examples_fun时本应产生“函数应有返回值”告警,但由于关掉了此告警信息显示,所以编译时将不会产生此告警提示101 C语言编程规范语言编程规范机械工程学院机械工程学院CoME10 10 代码编辑、编译、审查代码编辑、编译、审查½10-5:使用:使用代码检查工具代码检查工具(如(如C语言用语言用PC-Lint)对源程序检查对源程序检查½10-6:使用:使用软件工具软件工具(如(如 LogiSCOPE)进行代码审查进行代码审查102 C语言编程规范语言编程规范机械工程学院机械工程学院CoME11 代码测试、维护代码测试、维护103 C语言编程规范语言编程规范机械工程学院机械工程学院CoME11 11 代码测试、维护代码测试、维护¹11-1:单元测试要求:单元测试要求至少达到语句覆盖至少达到语句覆盖。

      ¹11-2::单单元元测测试试开开始始要要跟跟踪踪每每一一条条语语句句,,并并观观察察数数据据流流及及变量的变化变量的变化¹11-3:清理、整理或优化后的代码要经过审查及测试清理、整理或优化后的代码要经过审查及测试¹11-4::代码版本升级要经过严格测试代码版本升级要经过严格测试¹11-5:使用:使用工具软件工具软件对代码版本进行维护对代码版本进行维护¹11-6:正式版本上软件的:正式版本上软件的任何修改都应有详细的文档记录任何修改都应有详细的文档记录104 C语言编程规范语言编程规范机械工程学院机械工程学院CoME11 11 代码测试、维护代码测试、维护½11-1:发现错误立即修改,并且要记录下来发现错误立即修改,并且要记录下来½11-2:关键的代码在:关键的代码在汇编级跟踪汇编级跟踪½11-3::仔仔细细设设计计并并分分析析测测试试用用例例,,使使测测试试用用例例覆覆盖盖尽尽可可能能多多的的情情况况,,以以提高测试用例的效率提高测试用例的效率½11-4::尽尽可可能能模模拟拟出出程程序序的的各各种种出出错错情情况况,,对对出出错错处处理理代代码码进进行行充充分分的的测试½11-5:仔细测试代码处理数据、变量的边界情况。

      仔细测试代码处理数据、变量的边界情况½11-6:保留测试信息,以便分析、总结经验及进行更充分的测试保留测试信息,以便分析、总结经验及进行更充分的测试½11-7::不不应应通通过过“试试”来来解解决决问问题题,,应应寻寻找找问问题题的的根根本本原原因因我我是是用用试来查找问题的)试来查找问题的)105 C语言编程规范语言编程规范机械工程学院机械工程学院CoME11 11 代码测试、维护代码测试、维护½11-8::对对自自动动消消失失的的错错误误进进行行分分析析,,搞搞清清楚楚错错误误是是如如何何消消失失的的这这个个很有必要)很有必要)½11-9:修改错误不仅要治表,更要治本修改错误不仅要治表,更要治本说的很有道理)(说的很有道理)½11-10:测试时应设法使很少发生的事件经常发生测试时应设法使很少发生的事件经常发生½11-11:明确模块或函数处理哪些事件,并使它们经常发生明确模块或函数处理哪些事件,并使它们经常发生½11-12:: 坚坚持持在在编编码码阶阶段段就就对对代代码码进进行行彻彻底底的的单单元元测测试试,,不不要要等等以以后后的的测试工作来发现问题测试工作来发现问题½11-13::去去除除代代码码运运行行的的随随机机性性((如如去去掉掉无无用用的的数数据据、、代代码码及及尽尽可可能能防防止止并并注注意意函函数数中中的的“内内部部寄寄存存器器”等等)),,让让函函数数运运行行的的结结果果可可预预测测,,并并使出现的错误可再现。

      使出现的错误可再现106 C语言编程规范语言编程规范机械工程学院机械工程学院CoME11 11 代码测试、维护代码测试、维护½11-8::对对自自动动消消失失的的错错误误进进行行分分析析,,搞搞清清楚楚错错误误是是如如何何消消失失的的这这个个很有必要)很有必要)½11-9:修改错误不仅要治表,更要治本修改错误不仅要治表,更要治本说的很有道理)(说的很有道理)½11-10:测试时应设法使很少发生的事件经常发生测试时应设法使很少发生的事件经常发生½11-11:明确模块或函数处理哪些事件,并使它们经常发生明确模块或函数处理哪些事件,并使它们经常发生½11-12:: 坚坚持持在在编编码码阶阶段段就就对对代代码码进进行行彻彻底底的的单单元元测测试试,,不不要要等等以以后后的的测试工作来发现问题测试工作来发现问题½11-13::去去除除代代码码运运行行的的随随机机性性((如如去去掉掉无无用用的的数数据据、、代代码码及及尽尽可可能能防防止止并并注注意意函函数数中中的的“内内部部寄寄存存器器”等等)),,让让函函数数运运行行的的结结果果可可预预测测,,并并使出现的错误可再现使出现的错误可再现107 C语言编程规范语言编程规范机械工程学院机械工程学院CoME12 宏宏108 C语言编程规范语言编程规范机械工程学院机械工程学院CoME12 12 宏宏¹12-1:用宏定义表达式时,要使用完备的括号。

      用宏定义表达式时,要使用完备的括号示例:如下定义的宏都存在一定的风险示例:如下定义的宏都存在一定的风险define RECTANGLE_AREA( a, b ) a * b#define RECTANGLE_AREA( a, b ) (a * b)#define RECTANGLE_AREA( a, b ) (a) * (b)正确的定义应为:正确的定义应为:#define RECTANGLE_AREA( a, b ) ((a) * (b))109 C语言编程规范语言编程规范机械工程学院机械工程学院CoME12 12 宏宏¹12-2:将宏所定义的多条表达式放在大括号中将宏所定义的多条表达式放在大括号中示例:下面的语句只有宏的第一条表达式被执行为了说明问题,示例:下面的语句只有宏的第一条表达式被执行为了说明问题,for语语句的书写稍不符规范句的书写稍不符规范define INTI_RECT_VALUE( a, b )\ a = 0;\ b = 0;for (index = 0; index < RECT_TOTAL_NUM; index++) INTI_RECT_VALUE( rect.a, rect.b );110 C语言编程规范语言编程规范机械工程学院机械工程学院CoME12 12 宏宏正确的用法应为:正确的用法应为:#define INTI_RECT_VALUE( a, b )\{\ a = 0;\ b = 0;\}for (index = 0; index < RECT_TOTAL_NUM; index++){ INTI_RECT_VALUE( rect[index].a, rect[index].b );}111 C语言编程规范语言编程规范机械工程学院机械工程学院CoME12 12 宏宏¹12-3:使用宏时,不允许参数发生变化。

      使用宏时,不允许参数发生变化示例:如下用法可能导致错误示例:如下用法可能导致错误define SQUARE( a ) ((a) * (a))int a = 5;int b;b = SQUARE( a++ ); // 结果:结果:a = 7,即执行了两次增,即执行了两次增1正确的用法是:正确的用法是:b = SQUARE( a );a++; // 结果:结果:a = 6,即只执行了一次增,即只执行了一次增1112 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC语言与语言与C++的区别++的区别 113 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 1 1,全新的程序程序思维,,全新的程序程序思维,C C语言是面向过程语言是面向过程的,而的,而C C++是面向++是面向对象对象的 2 2,,C C语言有标准的函数库,它们松散的,只是把功能相同的函语言有标准的函数库,它们松散的,只是把功能相同的函数放在一个头文件中;而数放在一个头文件中;而C++对于大多数的函数都集成的很对于大多数的函数都集成的很紧密,紧密,特别是C语言中没有的C++中的API是对Window系统的大多数(Application Programming Interface 应用编程接口)API有机的组合,是一个集体。

      但你也可能单独调用API 114 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 3,特别是,特别是C++中的图形处理,它和语言的图形有很大的区别中的图形处理,它和语言的图形有很大的区别C语言中的图形处理函数基本上是不能用在C++中的C语言标准中不包括图形处理 4,,C和和C++中中都有都有结构的概念,但是在结构的概念,但是在C语言中结构只有成员语言中结构只有成员变量,变量,而没成员方法而没成员方法,而在,而在C++中结构中,它可以有自己的中结构中,它可以有自己的成员变量和成员函数但是在成员变量和成员函数但是在C语言中结构的成员是公共的,语言中结构的成员是公共的,什么想访问它的都可以访问;而在什么想访问它的都可以访问;而在VC++中它没有加限定符的中它没有加限定符的为私有的为私有的 115 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 5 5,,C C语言可以写很多方面的程序,但是语言可以写很多方面的程序,但是C++C++可以写得更多更好,可以写得更多更好,C++C++可以写基于可以写基于DOSrDOSr程序,写程序,写DLLDLL,写控件,写系统。

      写控件,写系统 6 6,,C C语言对程序的文件的组织是松散的,几乎是全要程序处理;语言对程序的文件的组织是松散的,几乎是全要程序处理;而而c++c++对文件的组织是以工程对文件的组织是以工程,各文件分类明确各文件分类明确 7 7,,C++C++中的中的(集成开发环境)IDEIDE很智能,和很智能,和VBVB一样,有的功能可能比一样,有的功能可能比VBVB还强116 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 8,,C++对可以自动生成你想要的程序结构使你可以省了很多时对可以自动生成你想要的程序结构使你可以省了很多时间有很多可用的工具如加入间有很多可用的工具如加入微软基础类(Microsoft Foundation Classes)MFC中的类的时候,加入变量的时候等等中的类的时候,加入变量的时候等等 9,,C++中的附加工具也有很多,可以进行系统的分析,可以查中的附加工具也有很多,可以进行系统的分析,可以查看看Application Programming Interface 应用编程接口((API);可以查看);可以查看控件。

      控件 10,调试功能强大,并且方法多样调试功能强大,并且方法多样 117 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 11. C程序员程序员可以省略函数原型可以省略函数原型,而,而C++不可以,一个不带参数不可以,一个不带参数的的C函数原型必须把函数原型必须把void写出来而写出来而C++可以使用空参数列可以使用空参数列表表12. C++中中new和和delete是对内存分配的运算符,取代了是对内存分配的运算符,取代了C中的中的malloc和和free118 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 13. 标准标准C++中的字符串类取代了中的字符串类取代了C标准标准C函数库函数库头文头文件中的字符数组处理函数件中的字符数组处理函数14.  C++中用来做控制态输入输出的中用来做控制态输入输出的iostream类库类库替代了标准替代了标准C中的中的stdio函数库15. C++中的中的try/catch/throw异常处理机制异常处理机制取代了标准取代了标准C中的中的setjmp()和和longjmp()函数。

      函数 119 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 16. 在在C++中还增加了中还增加了bool型变量和型变量和wchar_t型变量型变量::      wchar_t也是字符类型,但是是那些宽度超过也是字符类型,但是是那些宽度超过8位的数据类型位的数据类型许多外文字符集所含的数目超过许多外文字符集所含的数目超过256个,个,char字符类型无法完字符类型无法完全囊括wchar_t数据类型一般为数据类型一般为16位 标准标准C++的的iostream类库中包括了可以支持宽字符的类和类库中包括了可以支持宽字符的类和对象) ) 120 C语言编程规范语言编程规范机械工程学院机械工程学院CoMEC C语言与语言与C C++的区别++的区别 17. 在在C语言中,输入输出是使用语句语言中,输入输出是使用语句scanf()和和printf()来实现来实现的,而的,而C++中是使用类来实现的中是使用类来实现的       #include "iostream.h"       main()    //C++中中main()函数默认为函数默认为int型,而型,而C语言中默认为语言中默认为void型。

      型       {           int a;           cout<<"input a number: ";           cin>>a;             /*输入一个数值输入一个数值*/           cout<

      点击阅读更多内容
      关于金锄头网 - 版权申诉 - 免责声明 - 诚邀英才 - 联系我们
      手机版 | 川公网安备 51140202000112号 | 经营许可证(蜀ICP备13022795号)
      ©2008-2016 by Sichuan Goldhoe Inc. All Rights Reserved.