华为软件编程规范总则CHECKLIST

华为软件编程规范总则CHECKLISTAuthor: 华为Date:1 排版1-1：程序块要采用缩进风格编写，缩进的TAB键一个。

1-2：相对独立的程序块之间、变量说明之后必须加空行。

1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

1-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。

1-5：若函数或过程中的参数较长，则要进行适当的划分。

1-6：不允许把多个短语句写在一行中，即一行只写一条语句。

1-7：if、while、for、default、do等语句自占一行。

1-8：对齐只使用TAB键，不使用空格键。

1-9：函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case语句下的情况处理语句也要遵从语句缩进要求。

1-10：程序块的分界符（如C/C++语言的大括号'{'和'}'）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。

在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while0、switch、case 语句中的程序都要采用如上的缩进方式。

1-11：在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或者前后要加空格；进行非对等操作时，如果是关系密切的立即操作符（如－>），后不应加空格。

2 注释2-1：一般情况下，源程序有效注释量必须在20％以上。

2-2：说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。

2-3：源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。

华为软件编程规范和范例〔一〕=====[排版] ]=======.〔二〕======[注释]=======.〔三〕=====[标识符命名]=======.〔四〕=====[可读性]======.〔五〕=====[变量、结构]=====.〔六〕=====[函数、过程]=====.〔七〕=====[可测性]=====.〔八〕=====[程序效率]=====.〔九〕=====[质量保证]=====.〔十〕=====[代码编辑、编译、审查]=====.〔十一〕=====[代码测试、维护]=====.〔十二〕=====[宏]=====.〔一〕========[ 排版]========== ¹1-1：程序块要采用缩进风格编写，缩进的空格数为4个说明：对于由开发工具自动生成的代码可以有不一致。

¹1-2：相对独立的程序块之间、变量说明之后必须加空行示例：如下例子不符合规范。

Int ni;if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;应如下书写Int ni;if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].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 < BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++){... // program code}for (i = 0, j = 0;(i < first_word_length) && (j < second_word_length);i++, j++){... // program code}¹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：不允许把多个短语句写在一行中，即一行只写一条语句示例：如下例子不符合规范。

华为编程规范华为是一家世界知名的信息通信技术（ICT）解决方案供应商，为全球超过170个国家和地区的企业和消费者提供产品和服务。

在华为的软件开发过程中，编程规范起着至关重要的作用。

良好的编程规范有助于提高代码的质量和可维护性，减少错误和调试时间，提高开发效率。

以下是华为编程规范的一些核心要点：1. 命名规范：变量、函数、类等命名应具有清晰的含义，并遵循驼峰命名法。

变量和函数名应尽量简短明了，避免使用无意义的名字。

同时，要避免使用拼音或缩写，提高代码的可读性。

2. 注释规范：良好的注释是代码可读性的重要组成部分。

应在需要解释的地方进行注释，对于复杂的算法和逻辑，要详细解释思路和实现方法。

此外，对于代码片段的用途，也可以加上简短的注释。

注释应使用英文，避免使用拼音或其他不常见的语言。

3. 缩进和空格：合理的缩进和空格可以提高代码的可读性。

在华为的编程规范中，使用四个空格作为一个缩进层级。

在运算符和逗号等地方留有适当的空格，使代码更易于阅读。

4. 函数规范：函数应尽量简短，一个函数应有一个明确的目的。

函数命名要具有清晰的语义，能够准确描述函数的功能。

参数应尽量避免过多，遵循最小化设计原则。

5. 异常处理：在代码中应该考虑到可能出现的异常情况，并进行相应的处理。

捕获异常后，应该写明异常类型，并书写明确的处理逻辑。

6. 安全性考虑：在编写代码时，应始终考虑安全性。

避免使用已知存在安全漏洞的函数和方法，对于输入的数据进行合理的校验和过滤，防止代码被恶意攻击者利用。

7. 代码格式化：代码格式化可以提高代码的可读性，使代码更易于维护。

在华为的编程规范中，要求使用一致的缩进和空格，合理分行和对齐，并采用一致的命名风格。

8. 可移植性：考虑到不同平台和操作系统的差异，编写代码时应注重可移植性。

避免使用与操作系统和平台相关的特性和函数，尽量使用标准库和接口。

9. 性能优化：在编写代码时，应注重性能优化。

避免不必要的计算和内存开销，合理选择数据结构和算法。

[ 华为软件编程规范和范例]一、排版二、注释三、标识符命名四、可读性五、变量、结构六、函数、过程七、可测性八、程序效率九、质量保证十、代码编辑、编译、审查十一、代码测试、维护十二、宏〔一〕=====[排版]¹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;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STA T_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].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 < BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++){... // program code}for (i = 0, j = 0;(i < first_word_length) && (j < second_word_length);i++, j++){... // program code}¹1-5：若函数或过程中的参数较长，则要进行适当的划分示例：n7stat_str_compare((BYTE *) & stat_object,(BYTE *) & (act_task_table[taskno].stat_object),sizeof (_STA T_OBJECT));n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER+ index, stat_object );¹1-6：不允许把多个短语句写在一行中，即一行只写一条语句示例：如下例子不符合规范。

精选文档目录1 排版62 注释113 标识符命名184 可读性205 变量、结构226 函数、过程287 可测性368 程序效率409 质量保证4410 代码编辑、编译、审查5011 代码测试、维护5212 宏531 排版¹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;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].result_data != 0));¹1-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。

总体原则•清晰，易于维护、易于重构•简洁，易于理解，并且易于实现• 风格统一，代码整体风格保持统一• 通用性，遵循业界通用的编程规范目录结构建议将工程按照功能模块划份子目录(可参考头文件和源文件目录。

命名LiteOS 的功能模块划分)，子目录再定义• 使用驼峰风格进行命名，此风格大小写字母混用，不同单词间通过单词首字母大写来分开，具体规则如下：大驼峰，或者带有模块函数，自定义的类型前缀的大驼峰局部变量，函数参数，宏参数，结构体成员，联合体成员全局变量宏，枚举值小驼峰带'g_'前缀的小驼峰全大写并下划线分割带'_LOS'前缀和'H'内核头文件中防止重复包含的宏变量以下划线分割AaaBbb,XXX_AaaBbb aaaBbbg_aaaBbbAAA_BBB_LOS_MODULE_H• 全局函数、全局变量、宏、类型名、枚举名的命名，应当准确描述并全局惟一后缀，中间为大写模块名，• 在能够准确表达含义的前提下，局部变量，或者结构体、联合体的成员变量，其命名应尽可能简短• LiteOS 的对外API 使用LOS_Module_Func 的方式，如果有宾语采用前置的方式，比如：1. LOS_TaskCreate2. LOS_SwtmrStart3. LOS_SemPendkernel 目录下内部模块间接口使用OsModuleFunc 的方式，比如：1. OsTaskScan2. OsSwtmrStartarch 目录需要给上层模块提供LowLevel 接口，这部份接口采用ArchModuleFunc 的方式。

其他情况可采用ModuleFunc 的方式。

排版与格式•程序块采用缩进风格编写，使用空格而不是制表符( '\t' )进行缩进，每级缩进为 4 个空格• 采用K&R 风格作为大括号换行风格，即函数左大括号另起一行放行首，并独占一行，其他左大括号尾随语句放行末，右大括号独占一行，除非后面跟着同一语句的剩余部份，如if 语句的else/elseif 或者分号，比如：1. struct MyType {//左大括号尾随语句放行末，前置 1 个空格2. ...3. };//右大括号后面紧跟分号1. int Foo (int a)2. {//函数左大括号独占一行，放行首3. if(a>0){//左大括号尾随语句放行末，前置 1 个空格4. ...5. }else {//右大括号、 "else" 、以及后续的左大括号均在同一行6. ...7. }//右大括号独占一行8. ...9. }•条件、循环语句使用大括号，比如：1. if(objectIsNotExist){ //单行条件语句也加大括号2. return CreateNewObject ();3. }1. while (condition){} //即使循环体是空，也应使用大括号1. while (condition){2. continue ;//continue 表示空逻辑，使用大括号3. }•case/default 语句相对switch 缩进一层，缩进风格如下：1. switch (var){2. case 0://缩进一层3. DoSomething1 ();//缩进一层4. break ;5. case 1 :6. DoSomething2 ();7. break ;8. default :9. break ;10. }•一行只写一条语句• 一条语句不能过长，建议不超过120 个字符，如不能缩短语句则需要分行写• 换行时将操作符留在行末，新行进行同类对齐或者缩进一层，比如：1. //假设下面第一行不满足行宽要求2. if(currentValue>MIN&& //换行后，布尔操作符放在行末3. currentValue<MAX){ //与 (&&)操作符的两个操作数同类对齐4. DoSomething ();5. ...6. }1. //假设下面的函数调用不满足行宽要求，需要换行2. ReturnType result= FunctionName (paramName1,3. paramName2,4. paramName3); //保持与上方参数对齐1. ReturnType result= VeryVeryVeryLongFunctionName (// 写入第 1 个参数后导致过长，直接换行2. paramName1,paramName2,paramName3); //换行后， 4 空格缩进一层1. //每行的参数代表一组相关性较强的数据结构，放在一行便于理解，此时可理解性优先于格式排版要求2. int result= DealWithStructLikeParams (left.x,left.y, //表示一组相关参数3. right.x,right.y); //表示此外一组相关参数• 声明定义函数时，函数的返回类型以及其他修饰符，与函数名同行• 指针类型"*" 应该靠右尾随变量或者函数名，比如：1. int*p1;//Good ：右尾随变量，和左边的类型隔了 1 个空格2. int*p2;//Bad ：左尾随类型3. int*p3;//Bad ：两边都没空格4. int*p4;//Bad ：两边都有空格当"*"与变量或者函数名之间有其他修饰符，无法尾随时，此时也不要尾随修饰符，比如：1. char *const VERSION= "V100" ;//Good ：当有 const 修饰符时， "*"两边都有空格2. int Foo (constchar *restrictp); //Good ：当有 restrict 修饰符时， "*"两边都有空格•根据上下内容的相关程度，合理安排空行，但不要使用连续 3 个或者更多空行• 编译预处理的"#"统一放在行首，无需缩进。

华为编程规范华为编程规范是指在华为公司内部进行软件开发时所遵守的一套规范和标准，旨在提高代码的质量和可维护性。

下面是华为编程规范的主要内容。

一、命名规范：1. 变量和函数名应采用有意义的名称，尽量避免使用缩写或简写。

2. 变量名和函数名应使用小驼峰命名法，即首字母小写，后续单词首字母大写。

3. 常量名应使用大写字母和下划线，以增加可读性。

4. 类名应使用大驼峰命名法，即每个单词首字母大写。

5. 文件名应与其中的公共类名一致。

二、注释规范：1. 在每个函数的开头添加函数的功能说明，参数说明和返回值说明。

2. 在关键性代码部分添加注释，说明代码的逻辑。

3. 在需要修正或改进的代码部分添加TODO注释，以便后续修复。

三、代码风格：1. 缩进使用4个空格而不是Tab键。

2. 每行代码的长度不能超过80个字符。

3. 在二元操作符两边添加空格，例如 a + b。

4. 大括号应另起一行，不应与关键字在同一行。

5. 每个语句结束后都应该添加分号。

四、异常处理：1. 捕获异常时应尽量具体，不应捕获顶层异常。

2. 异常处理代码应与正常逻辑代码分离，以提高代码的可读性。

3. 异常处理代码块应添加注释，说明捕获的异常类型和处理的方法。

五、函数规范：1. 函数的长度应控制在100行以内，避免函数过长和复杂。

2. 函数的参数应尽量少，可以通过封装成结构体或类的方式来减少参数数量。

3. 函数应只完成一个功能，不应既完成数据处理又完成界面显示等功能。

六、代码复用：1. 尽量使用现有的类和框架来实现功能，避免重复造轮子。

2. 重复的代码应抽取成函数或方法来复用，提高代码的可维护性。

3. 提高代码的可移植性，使其可以在不同的平台和环境下复用。

七、测试规范：1. 添加单元测试用例，覆盖所有的代码分支，确保代码的正确性。

2. 针对不同的输入情况，测试代码的边界问题和异常情况。

3. 添加性能测试用例，确保代码在大数据量和高并发情况下的性能表现。

华为软件编程规范目录1 排版 62 注释113 标识符命名184 可读性205 变量、结构226 函数、过程287 可测性368 程序效率409 质量保证4410 代码编辑、编译、审查5011 代码测试、维护5212 宏53软件编程规范总则1 排版仅供内部使用71 排版¹1-1：程序块要采用缩进风格编写，缩进的空格数为4个。

说明：对于由开发工具自动生成的代码可以有不一致。

¹1-2：相对独立的程序块之间、变量说明之后必须加空行。

示例：如下例子不符合规范。

if (!valid_ni(ni)) {... // program code }repssn_ind =ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;应如下书写软件编程规范总则1 排版仅供内部使用7if (!valid_ni(ni)){... // program code }repssn_ind =ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni; ¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied = stat_poi[index].occupied;act_task_table[taskno].duration_true_or_false= SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)软件编程规范总则 1 排版仅供内部使用7&& (n7stat_stat_item_valid (stat_item))&& (act_task_table[taskno].result_data != 0));¹1-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。

华为软件编程规范和范例[ 华为软件编程规范和范例]一、排版二、注释三、标识符命名四、可读性五、变量、结构六、函数、过程七、可测性八、程序效率九、质量保证十、代码编辑、编译、审查十一、代码测试、维护十二、宏〔一〕=====[排版]¹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; repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读示例：perm_count_msg.head.len =NO7_TO_STAT_PERM_COUNT_LEN+STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id *STAT_TASK_CHECK_NUMBER +index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].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 <BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++){... // program code}for (i = 0, j = 0;(i < first_word_length) && (j <second_word_length);i++, j++){... // program code}¹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：不允许把多个短语句写在一行中，即一行只写一条语句示例：如下例子不符合规范。

华为软件编程规范和范例NetReptile推荐 [2006-5-23]出处：/oosky/作者：任我行〔一〕=====[排版] ]=======.〔二〕======[注释]=======.〔三〕=====[标识符命名]=======.〔四〕=====[可读性]======.〔五〕=====[变量、结构]=====.〔六〕=====[函数、过程]=====.〔七〕=====[可测性]=====.〔八〕=====[程序效率]=====.〔九〕=====[质量保证]=====.〔十〕=====[代码编辑、编译、审查]=====.〔十一〕=====[代码测试、维护]=====.〔十二〕=====[宏]=====.〔一〕=====[ 排版]¹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;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].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 < BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++){... // program code}for (i = 0, j = 0;(i < first_word_length) && (j < second_word_length);i++, j++){... // program code}¹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：不允许把多个短语句写在一行中，即一行只写一条语句示例：如下例子不符合规范。

文档编号产品版本受控状态DC-SB-2003-1005V 1.0 内部产品名称：软件编程规范共页软件编程规范(仅供内部使用)北京世纪百合科技有限公司Beijing Centurial Lily Technology Co.,Ltd.版权所有不得复制文档修改记录目录1.引言 (4)1.1 目的 (4)1.2 范围 (4)2.规范 (4)2.1 文件 (4)2.2版面风格 (8)2.3 标识符命名 (12)2.4 函数与宏 (14)2.5 代码的可靠性 (18)3.附录：通用类型的公共定义 (23)1.引言1.1目的本规范的目的在于增加源代码的可读性，减少程序员对代码理解上的偏差，使程序员能够编写出可靠的代码，降低代码维护成本。

1.2范围本规范内容涉及范围包括：文件、版面、注释、标识符、变量和结构、函数、宏以及可理解性等。

本规范适用于公司开发的所有软件产品。

在新软件的编码过程中本规范必须执行。

2.规范2.1文件2.1.1头文件的名称一律为小写，格式为“子系统名_文件名.h”。

例如：ipf_protocol.h等。

2.1.2头文件的格式如下：➢注释头，格式参见软件编程规范；➢头文件预编译开关开始，格式为：#ifndef 预编译开关#define 预编译开关其中预编译开关格式为：“ _文件名_H”，其中文件名一律大写➢头文件内容；➢头文件预编译开关结束，格式为：#endif用来和头文件预编译开关的开始对应。

例如：以下为ipf_ip.h头文件的内容：/************************************************************ Copyright (c) Lily Of The Century Technology Co., LTD.ALL RIGHTS RESERVEDDescription: // 用于详细说明此程序文件完成的主要功能*************************************************************/#ifndef _IPF_IP_H#define _IPF_IP_H...<头文件正文>...#endif2.1.3头文件的定义要有层次，禁止交叉引用。

精选文档目录1 排版62 注释113 标识符命名184 可读性205 变量、结构226 函数、过程287 可测性368 程序效率409 质量保证4410 代码编辑、编译、审查5011 代码测试、维护5212 宏531 排版¹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;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].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_table[taskno].result_data != 0));¹1-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。