《华为编程规范》由会员分享，可在线阅读，更多相关《华为编程规范（52页珍藏版）》请在金锄头文库上搜索。
1、目录1 排版62 注释113 标识符命名184 可读性205 变量、结构226 函数、过程287 可测性368 程序效率409 质量保证4410 代码编辑、编译、审查5011 代码测试、维护52宏53软件编程规范总则1排版1排版11-1 :程序块要采用缩进风格编写，缩进的空格数为4个。说明：对于由开发工具自动生成的代码可以有不一致。11-2 :相对独立的程序块之间、变量说明之后必须加空行。示例：如下例子不符合规范。if (!valid_ni( ni)./ program coderepss nnd = ssn _datai ndex.repss nn dex;repss n_ni = ssn
2、_datai ndex. ni;应如下书写if (!valid_ni( ni)./ program coderepss nnd = ssn _datai ndex.repss nn dex;repss n_ni = ssn _datai ndex. ni;11-3 :较长的语句(80字符)要分成多行书写，长表达式要在低优先级操作符处 划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐， 语句可读。示例：perm_cou nt_msg.head.le n = NO7_TO_STAT_PERM_COUNT_LEN+STAT_SIZE_PER_FRAM * sizeof( _UL
3、 );act_task_tableframe_id * STAT_TASK_CHECK_NUMBER +in dex.occupied=stat_poi in dex.occupied;act_task_tabletask no.durati on _true_or_false=SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = (task no MAX_ACT_TASK_NUMBER)&(n 7stat_stat_item_valid(stat_item)&(act_task_tabletask no .result_
4、data != 0);11-4 :循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表 达式要在低优先级操作符处划分新行，操作符放在新行之首。示例：if (task no max_act_task_ nu mber)& (n 7stat_stat_item_valid (stat_item)./ program codefor (i = 0, j = 0; (i BufferKeywordword_i ndex.word_le ngth)&(j NewKeyword.word_le ngth);i+, j+)./ program codefor (i = 0, j = 0;(i
5、first_word_le ngth) & (j ),后不应加空格。说明：采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必 要再留空格，如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不 需要加空格，多重括号间不必加空格，因为在C/C+语言中括号已经是最清晰 的标志了。在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不 加空格。给操作符留空格时不要连续留两个以上空格。示例：(1)逗号、分号只在后面加空格int a, b, c; 比较操作符，赋值操作符=、+=，算术操作符+、，逻辑操作符&、&，位域操作
6、符VV、A等双目操作符的前后加空格。if (curre nt_time = MAX_TIME_VALUE) a = b + c;a *= 2;a = b A 2;p-id = pid; / -指针前后不加空格!、+.格。、-、&(地址运算符)等单目操作符前后不加空*p = a;/内容操作*与内容之间flag = !isEmpty; /非操作!与内容之间p = & mem;/地址操作&与内容之间i+;/ +,-与内容之间-、.前后不加空格(5) if 、for、while 、switch等与后面的括号间应加空格，使if等关键字更为突出、明显。if (a = b & c d)?1-1: 一行程序以
7、小于80字符为宜，不要写得过长。仅供内部使用#软件编程规范总则2注释注释12-1 : 一般情况下，源程序有效注释量必须在 20 %以上。说明：注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不 宜太多也不能太少，注释语言必须准确、易懂、简洁。12-2 :说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg 等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、 功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述 信息建议要包含在内。/*Copyr
8、ight (C), 1988-1999, Huawei Tech. Co., Ltd.File name: /文件名Author:Versio n:Date: /作者、版本及完成日期Descripti on: /用于详细说明此程序文件完成的主要功能，与其他模块/或函数的接口，输出值、取值范围、含义及参数间的控/制、顺序、独立或依赖等关系Others:/其它内容的说明Fu ncti on List: /主要函数列表，每条记录应包括函数名及功能简要说明1History:/修改历史记录列表，每条修改记录应包括修改日期、修改/者及修改内容简述1. Date:Author:Modificati on:2
9、.仅供内部使用#软件编程规范总则2注释FileName: test.cpp Author:Versio n :Descripti on:/Versio n:/Fun cti on List: /1.History:/ David 96/10/1212- 3 :源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块 目的/功能、主要函数及其功能、修改日志等。示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述 信息建议要包含在内。/*Copyright (C), 1988-1999, Huawei Tech. Co., Ltd.Date:模块描述版本信息主要函数及其功能历史修改记录vversi on 1.0 build this moudle*说明：Description一项描述本文件的内容、功能、内部各部分之间的关系及本文件与其它文件关系等。History是修改历史记录列表，每条修改记录应包括修改日期、修改者及修改内容简述。12-4 :函数头部应进行注释，列出：函数的目的 /功能、输入参数、输出参数、返 回值、调用关系（函数、表）等。示例：下面这段函数的注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。Fun cti on:/函数名称Descripti
