c编程规范和范例

编译、审查 维护611182022283640445052531排版2注释3标识符命名4可读性5变量、结构6函数、过程7可测性8程序效率9质量保证10代码编辑、11代码测试、12宏1排版1-1:程序块要采用缩进风格编写,缩进的空格数为4个。说明:对于由开发工具自动生成的代码可以有不一致。1-2S相对独立的程序块之间、变量说明之后必须加空行。示例:如下例子不符合规范。if (!valid_ni(ni)(./ program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;应如下书写if (!valid_ni (ni) / program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;3:较长的语句(80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行, 操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。示例:perm_count_msg.head.len = N0TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof ( _UL );act_task_tableframe_id * STAT_TASK_CHECK_NUMBER + index.occupied = stat_poiindex.occupied;act_task_tabletaskno.duration_true_or-false=SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = ( (taskno MAX_ACT_TASK_NUMBER)& (n7stat_stat_item_valid (stat_item)& (act_task_tabletaskno.result_data != 0);1-4：循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低 优先级操作符处划分新行,操作符放在新行之首。示例:if (taskno max_act_task_number)& (n7stat_stat_item_valid (stat_item) (. / program code for (i = 0, j = 0; (i BufferKeywordword_index.word_length) & (j NewKeyword.word_length); i+, j+)(. / program code for (i = 0, j = 0;(i first_word_length) & (j case语句中的程序都要采用如上的缩进方式。示例：如下例子不符合规范。for ()./ program codeif ()(./ program codevoid example_fun( void ) ( . / program code 应如下书写。 for () . / program codeif () ( / program codevoid example_fun( void ) Z/ program codel-ll!在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或 者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如一),后不应加空 格。说明:采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格, 如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间 不必加空格，因为在C/C+语言中括号已经是最清晰的标志了。在长语句中，如果需要加的空格非常多，那么应该保持整体淸晰，而在局部不加空格。给 操作符留空格时不要连续留两个以上空格。示例:(1)逗号、分号只在后面加空格。int a, b, c;(2)比较操作符,赋值操作符=、+=算术操作符+逻辑操作符,&、&(位域操作符= MAX_TIME_VALUE)a = b + c;a = 2;a = b A 2;(3)!、+、一、&(地址运算符)等单目操作符前后不加空格。*P = a;/内容操作*与内容之间flag = iisEmpty; /非操作！与内容之间p = &mem;/Z地址操作&与内容之间i + + ;/ + +与内容之间(4)前后不加空格。p-id = pid; / -指针前后不加空格(5) if、for、while, switch等与后面的括号间应加空格,使if等关键字更为突出、 明显。if (a = b & c d)/21-1S 一行程序以小于80字符为宜,不要写得过长。2注释*2-1, 一般情况下,源程序有效注释量必须在20%以上。说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不 能太少,注释语言必须准确、易懂、简洁。*2-2:说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应 进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的 关系、修改日志等,头文件的注释中还应有函数功能简要说明。示例:下面这段头文件的头注释比较标准，当然，并不局限于此格式,但上述信息建议要 包含在内。/* Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. File name:/Z 文件名Author:Version:Date: /作者、版本及完成日期Description : /Z用于详细说明此程序文件完成的主要功能,与其他模块/Z或函数的接口,输出值、取值范围、含义及参数间的控/Z制、顺序、独立或依赖等关系Others :/Z其它内容的说明Function List: /主要函数列表,每条记录应包括函数名及功能简要说明1History:/Z修改历史记录列表,每条修改记录应包括修改日期、修改/者及修改内容简述1. Date:Author:Modification: 2. */2-3:源文件头部应进行注释，列出:版权说明、版本号、生成日期、作者、模块目的/功能、 主要函数及其功能、修改日志等。示例:下而这段源文件的头注释比较标准，当然,并不局限于此格式，但上述信息建议要 包含在内。Copyright （C）, 19881999, Huawei Tech. Co., Ltd.FileName: test.cppAuthor:Version :Date:Description:/Z 模块描述Version:/Z版本信息Function List:/主要函数及其功能1*History:/7历史修改记录 David 96/10/121.0 build this moudle夫*I说明:Description 项描述本文件的内容、功能、内部各部分之间的关系及本文件与 其它文件关系等。History是修改历史记录列表,每条修改记录应包括修改日期、修改 者及修改内容简述。*2-4；函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用 关系（函数、表）等。示例：下面这段函数的注释比较标准,当然,并不局限于此格式,但上述信息建议要包含 在内。/Function:/Z函数名称Description:/Z函数功能、性能等的描述Calls:/Z被本函数调用的函数清单Called By:/Z调用本函数的函数清单Table Accessed: /Z被访问的表（此项仅对于牵扯到数据库操作的程序）Table Updated: /Z被修改的表（此项仅对于牵扯到数据库操作的程序）Input:/Z输入参数说明，包括每个参数的作/Z用、取值说明及参数间关系。Output:/Z对输出参数的说明。Return:/Z函数返回值的说明Others:/Z其它说明*/*2-5：边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。不再有 用的注释要删除。）2-6S注释的内容要清楚、明了,含义准确,防止注释二义性。说明:错误的注释不但无益反而有害。规则2-7:避免在注释中使用缩写,特别是非常用缩写。说明:在使用缩写时或之前,应对缩写进行必要的说明。*2-8S注释应与其描述的代码相近,对代码的注释应放在其上方或右方（对单条语句的注释） 相邻位置，不可放在下面，如放于上方则需与其上面的代码用空行隔开。示例：如下例子不符合规范。例1:/* get replicate sub system index and net indicator */repssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;例2:repssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;/* get replicate sub system index and net indicator */应如下书写/* get replicate sub system index and net indicator */ repssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;9,对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加 以注释,说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方。示例:/* active statistic task number */#define MAX_ACT_TASK_NUMBER 1000#define MAX_ACT_TASK_NUMBER 1000 /* active statistic task number */ -2-10:数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须 加以注释。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注 释放在此域的右方.示例:可按如下形式说明枚举/数据/联合结构。/* seep interface with seep user primitive message name */enum SCCP_USER_PRIMITIVE (N_UNTDATAJND, /* seep notify seep user unit data come */ N_NOTCE_ND,/* seep notify user the No. 7 network can not */* transmission this message */N_UNITDATA_REQ, / * seep user 1s unit data transmission request */ ；2-11;全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及 存取时注意事项等的说明。示例:/* The ErrorCode when SCCP translate */* Global Title failure, as follows */ /Z 变量作用、含义/* 0 SUCCESS 1 GT Table error */* 2 GT error Others - no use */ /Z 变量取值范围/* only function SCCPTranslate () in */* this modual can modify it, and other */* module can visit it through call */* the function GetGTTransErrorCode () */ 使用方法BYTE g_GTTranErrorCode;-2-12S注释与所描述内容进行同样的缩排。说明：可使程序排版整齐,并方便注释的阅读与理解。示例:如下例子,排版不整齐,阅读稍感不方便。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*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 two*2-14：对变量的定义和分支语句(条件分支、循环语句等)必须编写注释.说明:这些语句往往是程序实现某一特定功能的关键,对于维护人员来说,良好的注释帮 助更好的理解程序,有时甚至优于看设计文档。,2-15：对于switch语句下的case语句,如果因为特殊情况需要处理完一个case后进入下 个case处理,必须在该case语句处理完、下个case语句前加上明确的注释。说明：这样比较清楚程序编写者的意图，有效防止无故遗漏break语句。示例(注意斜体加粗部分)：case CMD_UP:ProcessUp();break;case CMD_DOWN:ProcessDown();break;case CMD_FWD:ProcessFwd();if () (break; else (ProcessCFW_B () ;/ now jump into case CMD_Acase CMD_A:ProcessA();break;case CMD_B:ProcessB ();break;case CMD_C:ProcessC ();break;case CMD_D:ProcessD ();break;V22-1i避免在一行代码或表达式的中间插入注释。说明:除非必要,不应在代码或表达中间揷入注释,否则容易使代码可理解性变差。%2-2:通过对函数或过程、变量、结构等正确的命名以及合理地组织代码的结构,使代码成为 自注释的。说明:清晰准确的函数、变量等的命名,可增加代码可读性,并减少不必要的注释。V22-3:在代码的功能、意图层次上进行注释,提供有用、额外的信息。说明:注释的目的是解释代码的目的、功能和采用的方法,提供代码以外的信息，帮助读 者理解代码，防止没必要的重复注释信息。示例：如下注释意义不大。/* if receive_flag is TRUE */if (receive_flag)而如下的注释则给出了额外有用的信息。/* if mtp receive a message from links */if (receive_flag)V22-4:在程序块的结束行右方加注释标记,以表明某程序块的结束。说明:当代码段较长,特别是多重嵌套时,这样做可以使代码更淸晰,更便于阅读。示例:参见如下例子。if ()(/ program codewhile (index MAX_INDEX)/ program code /* end of while (index 3-5:命名规范必须与所使用的系统风格保持一致,并在同一项目中统,比如采用UNX的 全小写加下划线的风格或大小写混排的方式,不要使用大小写与下划线混排的方式,用作特殊 标识如标识成员变量或全局变量的m_和g_,其后加上大小写混排的方式是允许的。不例: Add_User 不允许,add_user AddUser m_AddUser 允许。田!:除非必要,不要用数字或较奇怪的字符来定义标识符。示例:如下命名,使人产生疑惑。# define _EXAMPLE_0_TEST_# define _EXAMPLE_1_TEST_ void set_sls00( BYTE sis );应改为有意义的单词命名# define _EXAMPLE_UNIT_TEST_# define _EXAMPLE_ASSERT_TEST_ void set_udt_msg_sls( BYTE sis );%32 在同一软件产品内,应规划好接口部分标识符(变量、结构、函数及常量)的命名,防 止编译、链接时产生冲突。说明:对接口部分的标识符应该有更严格限制,防止冲突。如可规定接口部分的变量与常 量之前加上“模块”标识等。233用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。说明:下面是些在软件中常用的反义词组。 add / remove begin / end insert / delete first / last increment / decrementadd / delete min / max next / previous send / receive cut / paste示例:int min_sum;lock / unlock old / newsource / targetcreate / destroy get / release put / getopen / closestart / stop show / hidesource / destinationup / downint max_sum;int add_user( BYTE *user_name );int delete_user( BYTE *user_name );V23-4I除了编译开关/头文件等特殊应用,应避免使用:XAMPLE_TEST_之类以下划线开始和 结尾的定义.4可读性*4-1;注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。说明:防止阅读程序时产生误解,防止因默认的优先级与设计思想不符而导致程序出错。示例:下列语句中的表达式word = (high 8) | low (1) if (a I b) & (a & c) )(2)if (a I b) (c & d)(3)如果书写为high 8 | low a I b & a & c a I b c & d 由于high 8 | low = ( high 8) | low,a I b & a & c = (a | b) & (a & c),(1)(2)不会出错,但语句不易理解:a|bc&d = a| (b c) &d, (3)造成了判断条件出错。(4-2：避免使用不易理解的数字,用有意义的标识来替代。涉及物理状态或者含有物理意义的 常量，不应直接使用数字,必须用有意义的枚举或宏来代替。示例：如下的程序可读性差。if (Trunkindex.trunk_state = 0)Trunkindex.trunk_state = 1; Z/ program code应改为如下形式。#define TRUNK_DLE 0define TRUNK_BUSY 1if (Trunkindex.trunk_state = TRUNK_IDLE)Trunk index .trunk_state = TRUNK_BUSY;. / program code/24-1:源程序中关系较为紧密的代码应尽可能相邻。说明:便于程序阅读和查找。示例:以下代码布局不太合理。rect.length = 10;char_poi = str;rect.width = 5;若按如下形式书写,可能更清晰些。rect.length = 10;rect .width = 5; /矩形的长与宽关系较密切,放在起。char_poi = str;/24-2S不要使用难懂的技巧性很髙的语句,除非很有必要时.说明：高技巧语句不等于高效率的程序,实际上程序的效率关键在于算法。 示例：如下表达式，考虑不周就可能出问题，也较难理解。* stat_poi + += 1;* + stat_poi += 1;应分别改为如下。* stat_poi += 1;* tat_poi + + ; /Z 此二语句功能相当于* stat_poi + += 1;* + stat_poi;* stat_poi += 1; / 此二语句功能相当于* + stat_poi += 1;5变量、结构* 5-1,去掉没必要的公共变量。说明:公共变量是增大模块间耦合的原因之一,故应减少没必要的公共变量以降低模块冋 的耦合度。* 5-2:仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。说明:在对变量声明的同时,应对其含义、作用及取值范围进行注释说明,同时若有必要 还应说明与其它变量的关系。5-3S明确公共变量与操作此公共变量的函数或过程的关系,如访问、修改及创建等。说明：明确过程操作变量的关系后，将有利于程序的进步优化、单元测试、系统联调以 及代码维护等。这种关系的说明可在注释或文档中描述。示例：在源文件中，可按如下注释形式说明。RELATION System_Init Input_Rec Print_Rec Stat_Score StudentCreateModifyAccessAccessScoreCreateModifyAccessAccess,Modify注:RELATION 为操作关系;System_Init、Input_Rec、Print_Rec、Stat_Score 为四个不同的函数;Studentx Score为两个全局变量;Create表示创建，Modify表 示修改，Access表示访问。其中，函数Input_Rec、Stat_Score都可修改变量Score,故此变量将引起函数间较 大的耦合，并可能增加代码测试、维护的难度。15-4:当向公共变量传递数据时,要十分小心,防止赋与不合理的值或越界等现象发生。说明:对公共变量赋值时,若有必要应进行合法性检查,以提高代码的可靠性、稳定性。* 5-5:防止局部变量与公共变量同名。说明:若使用了较好的命名规则,那么此问题可自动消除。* 5-6:严禁使用未经初始化的变量作为右值。说明：特别是在C/C+ +中引用未经赋值的指针,经常会引起系统崩溃。/25-1S构造仅有一个模块或函数可以修改、创建,而其余有关模块或函数只访问的公共变量, 防止多个不同模块或函数都可以修改、创建同一公共变量的现象。说明:降低公共变量耦合度。V25-2i使用严格形式定义的、可移植的数据类型,尽量不要使用与具体硬件或软件环境关系密 切的变量。说明:使用标准的数据类型,有利于程序的移植。示例：如下例子(在DOS下BC3.1环境中),在移植时可能产生问题。 void main() (register int index; / 寄存器变量_AX = 0x4000; / 一AX是BC3.1提供的寄存器“伪变量” . / program code 必53:结构的功能要单,是针对种事务的抽象。说明:设计结构时应力争使结构代表种现实事务的抽象,而不是同时代表多科结构中 的各元素应代表同一事务的不同侧面,而不应把描述没有关系或关系很弱的不同事务的元 素放到同一结构中。示例:如下结构不太清晰、合理。typedef struct STUDENT_STRU unsigned char name8; /* student * s name /unsigned char age;/* student1s age */unsigned char sex;/* student * s sex, as follows */* 0 - FEMALE; 1 - MALE */ unsigned charteacher_name8; /* the student teacher * s name */ unisgned charteacher_sex; /* his teacher sex */ STUDENT;若改为如下,可能更合理些。typedef struct TEACHER_STRUunsigned char name8; /* teacher name */unisgned char sex; /* teacher sex, as follows /* 0 - FEMALE; 1 - MALE */ TEACHER;typedef struct STUDENT_STRUunsignedcharname8;/*studentsname*/unsignedcharage;studentsage */unsignedcharsex;/*student1ssex,as follows */* 0 - FEMALE; 1 - MALE */unsigned int teacher_ind; /* his teacher index */ STUDENT;V25-4,不要设计面面俱到、非常灵活的数据结构。说明:面面俱到、灵活的数据结构反而容易引起误解和操作困难。%5-5:不同结构间的关系不要过于复杂。说明:若两个结构间关系较复杂、密切,那么应合为个结构。示例：如下两个结构的构造不合理。typedef struct PERSON_ONE_STRU(unsigned char name8;unsigned char addr40;unsigned char sex;unsigned char city15; PERSON_ONE;typedef struct PERSON_TWO_STRU(unsigned char name8;unsigned char age;unsigned char tel; PERSON_TWO;由于两个结构都是描述同一事物的,那么不如合成一个结构。 typedef struct PERSON_STRU(unsigned char name8;unsigned char age;unsigned char sex;unsigned char addr40;unsigned char city 15;unsigned char tel; PERSON;25-6:结构中元素的个数应适中.若结构中元素个数过多可考虑依据某种原则把元素组成不同 的子结构,以减少原结构中元素的个数。说明:增加结构的可理解性、可操作性和可维护性。示例:假如认为如上的PERSON结构元素过多,那么可如下对之划分。typedef struct PERSON_BASE_INFO_STRUunsigned char name8;unsigned char age;unsigned char sex; PERSON_BASE_INFO;typedef struct PERSON_ADDRESS_STRU (unsigned char addr40;unsigned char city15; unsigned char tel; PERSON_ADDRESS;typedef struct PERSON_STRU(PERSON_BASE_INFO person_base;PERSON_ADDRESS person_addr; PERSON;%5-7:仔细设计结构中元素的布局与排列顺序,使结构容易理解、节省占用空间,并减少引起 误用现象。说明:合理排列结构中元素顺序,可节省空间并增加可理解性。示例:如下结构中的位域排列,将占较大空间,可读性也稍差。typedef struct EXAMPLE_STRU(unsigned int valid: 1;PERSON person;unsigned int set_f1g: 1; EXAMPLE;若改成如下形式,不仅可节省1字节空间,可读性也变好了。typedef struct EXAMPLE_STRU(unsigned int valid: 1;unsigned int set_f 1g: 1;PERSON person ; EXAMPLE;V25-8:结构的设计要尽量考虑向前兼容和以后的版本升级,并为某些未来可能的应用保留余地 (如预留一些空间等)。说明:软件向前兼容的特性,是软件产品是否成功的重要标志之一。如果要想使产品具有 较好的前向兼容,那么在产品设计之初就应为以后版本升级保留一定余地,并且在产品升 级时必须考虑前一版本的各种特性。V25-9I留心具体语言及编译器处理不同数据类型的原则及有关细节。说明:如在C语言中,static局部变量将在内存“数据区”中生成,而非static局部 变量将在“堆栈”中生成。这些细节对程序质量的保证非常重要。V25-10S编程时,要注意数据类型的强制转换.说明：当进行数据类型强制转换时，其数据的意义、转换后的取值等都有可能发生变化， 而这些细节若考虑不周，就很有可能留下隐患。25-11:对编译系统默认的数据类型转换,也要有充分的认识。示例：如下赋值，多数编译器不产生告警，但值的含义还是稍有变化。char chr;unsigned short int exam;chr = -1;exam = chr; /Z编译器不产生告警,此时exam为OxFFFF。力5-12:尽量减少没有必要的数据类型默认转换与强制转换.力5-13:合理地设计数据并使用自定义数据类型,避免数据间进行不必要的类型转换。5-14：对自定义数据类型进行恰当命名,使它成为自描述性的,以提高代码可读性。注意其 命名方式在同一产品中的统说明:使用自定义类型,可以弥补编程语言提供类型少、信息量不足的缺点,并能使程序 清晰、简洁。示例:可参考如下方式声明自定义数据类型。下面的声明可使数据类型的使用简洁、明了。typedef unsigned char BYTE;typedef unsigned short WORD;typedef unsigned int DWORD;下面的声明可使数据类型具有更丰富的含义。typedef float DISTANCE;typedef float SCORE;25-15:当声明用于分布式环境或不同CPU间通信环境的数据结构时,必须考虑机器的字节顺 序、使用的位域及字节对齐等问题.说明：比如Intel CPU与68360 CPU,在处理位域及整数时,其在内存存放的“顺序” 正好相反。示例：假如有如下短整数及结构。unsigned short int exam;typedef struct EXAM_BIT_STRU/* Intel 68360 */unsigned int Al: 1; /* bit 07*/unsigned int A2: 1; /* bit 16 */unsigned int A3: 1; /* bit 2 EXAM_BIT;intel CPU生成短整数及位域的方式。内存:（从低到高,以字节为单位）examexam低字节exam咼字节内存:0 bit1 bit2 bit（字节的各“位”）EXAMBITAlA2A368360CPU生成短整数及位域的方式。内存:（从低到高,以字节为单位）examexam高字节 exam低字节内存:7 bit6 bit5 bit（字节的各“位”）EXAMBITAlA2A3说明:在对齐方式下,CPU的运行效率要快得多。示例:如下图,当个long型数（如图中longl）在内存中的位置正好与内存的字边界 对齐时,CPU存取这个数只需访问次内存,而当个long型数（如图中的long2）在 内存中的位置跨越了字边界时,CPU存取这个数就需要多次访问内存,如i960cx访问这 样的数需读内存三次（个BYTE、个SHORT、个BYTE,由CPU的微代码执行,对 软件透明）,所有对齐方式下CPU的运行效率明显快多了。18162432I longl | longl | longl | longl |1111 long2 II long2 I long2 | long2 |6函数、过程16-1:对所调用函数的错误返回码要仔细、全面地处理。*6-2S明确函数功能,精确(而不是近似)地实现函数设计.16-3:编写可重入函数时,应注意局部变量的使用(如编写C/C+语言的可重入函数时,应使 用aut。即缺省态局部变量或寄存器变量)。说明:编写C/C+语言的可重入函数时,不应使用static局部变量,否则必须经过特殊 处理,才能使函数具有可重入性。*6-4S编写可重入函数时,若使用全局变量,则应通过关中断、信号量(即P、V操作)等手段 对其加以保护。说明:若对所使用的全局变量不加以保护，则此函数就不具有可重入性,即当多个进程调 用此函数时，很有可能使有关全局变量变为不可知状态。示例:假设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( ) M 后,计算出的temp很可能不是预想中的结果。此函数应如下改进。unsigned int example( int para )unsigned int temp;申请信号量操作/若申请不到“信号量”,说明另外的进程正处于Exam = para;/给Exam赋值并计算其平方过程中(即正在使用此temp = Square_Exam ( ) ; /信号),本进程必须等待其释放信号后,可继 释放信号量操作/续执行。若申请到信号,则可继续执行,但其/Z它进程必须等待本进程释放信号量后,才能再使/Z用本信号。return temp;)6-5S在同一项目组应明确规定对接口函数参数的合法性检査应由函数的调用者负责还是由接 函数本身负责,缺省是由函数调用者负责。说明:对于模块间接口函数的参数的合法性检查这一问题,往往有两个极端现象,即:要 么是调用者和被调用者对参数均不作合法性检査，结果就遗漏了合法性检査这必要的处 理过程，造成问题隐患:要么就是调用者和被调用者均对参数进行合法性检查，这种情况 虽不会造成问题,但产生了冗余代码，降低了效率。V26-1:防止将函数的参数作为工作变量。说明：将函数的参数作为工作变量，有可能错误地改变参数内容，所以很危险。对必须改 变的参数，最好先用局部变量代之，最后再将该局部变量的内容赋给该参数。示例：下函数的实现不太好。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 b ) ? a : b ;改为如下就很清晰了。int max (int az int b)(return (a b) ? a : b);)value = max (a, b);或改为如下。#define MAX (a, b) (a) (b) ? (a) : (b)value = MAX (a, b);66不要设计多用途面面俱到的函数。说明:多功能集于一身的函数,很可能使函数的理解、测试、维护等变得困难。66函数的功能应该是可以预测的,也就是只要输入数据相同就应产生同样的输出。说明:带有内部“存储器”的函数的功能可能是不可预测的,因为它的输出可能取决于内 部存储器(如某标记)的状态。这样的函数既不易于理解又不利于测试和维护。在C/C+ 语言中,函数的static局部变量是函数的内部存储器,有可能使函数的功能不可预测， 然而,当某函数的返回值为指针类型时，则必须是STATIC的局部变量的地址作为返回值, 若为AUTO类，则返回为错针。示例:如下函数，其返回值(即功能)是不可预测的。unsigned int integer_sum( unsigned int base ) (unsigned int index;static unsigned int sum = 0; / 注意,是 static 类型的。/若改为aut。类型,则函数即变为可预测。for (index = 1; index = base; index+)(sum += index;return sum;)V26-7S尽量不要编写依赖于其他函数内部实现的函数。说明：此条为函数独立性的基本要求。由于目前大部分高级语言都是结构化的,所以通过 具体语言的语法要求与编译器功能,基本就可以防止这种情况发生。但在汇编语言中,由 于其灵活性，很可能使函数出现这种情况。示例：如下是在DOSTASM的汇编程序例子。过程Print_Msg的实现依赖于 Input_Msg的具体实现,这种程序是非结构化的,难以维护、修改。./程序代码proc Print_Msg /Z 过程(函数)Print_Msg./程序代码jmp LABEL./程序代码endpproc Input_Msg /Z 过程(函数)Input_Msg./程序代码LABEL:./程序代码endpV26-8:避免设计多参数函数,不使用的参数从接口中去掉。说明:目的减少函数间接口的复杂度。非调度函数应减少或防止控制参数,尽量只使用数