华为C语言编程规范
- 格式：pdf
- 大小：469.55 KB
- 文档页数：59
下载文档原格式
合集下载
华为C++语言通用编程规范
我们推荐使用.h 作为头文件的后缀，这样头文件可以直接兼容 C 和 C++。 我们推 荐使用.cpp 作为实现文件的后缀，这样可以直接区分 C++代码，而不是 C 代码。
目前业界还有一些其他的后缀的表示方法：
• 头文件： .hh, .hpp, .hxx • cpp 文件：.cc, .cxx, .C
对于本文档，我们默认使用.h 和.cpp 作为后缀。
uint8_t
宽度恰为 8 的有/无符号整数类型
int16_t
uint16_t 宽度恰为 16 的有/无符号整数类型
int32_t
uint32_t 宽度恰为 32 的有/无符号整数类型
int64_t
uint64_t 宽度恰为 64 的有/无符号整数类型
intptr_t
uintptr_t 足以保存指针的有/无符号整数类型
// typedefs typedef std::map<std::string, UrlTableProperties*> PropertiesMap;
// enums enum UrlTableErrors { ...
对于命名空间的命名，建议全小写：
// namespace namespace osutils {
建议 2.2.2 C++文件名和类名保持一致
C++的头文件和 cpp 文件名和类名保持一致，使用下划线小写风格。
如下： - database_connection.h - database_connection.cpp
结构体，命名空间，枚举等定义的文件名类似。
函数命名
函数命名统一使用大驼峰风格，一般采用动词或者动宾结构。接口部分可加前缀， 如 XXX_函数名。
目前业界还有一些其他的后缀的表示方法：
• 头文件： .hh, .hpp, .hxx • cpp 文件：.cc, .cxx, .C
对于本文档，我们默认使用.h 和.cpp 作为后缀。
uint8_t
宽度恰为 8 的有/无符号整数类型
int16_t
uint16_t 宽度恰为 16 的有/无符号整数类型
int32_t
uint32_t 宽度恰为 32 的有/无符号整数类型
int64_t
uint64_t 宽度恰为 64 的有/无符号整数类型
intptr_t
uintptr_t 足以保存指针的有/无符号整数类型
// typedefs typedef std::map<std::string, UrlTableProperties*> PropertiesMap;
// enums enum UrlTableErrors { ...
对于命名空间的命名，建议全小写：
// namespace namespace osutils {
建议 2.2.2 C++文件名和类名保持一致
C++的头文件和 cpp 文件名和类名保持一致，使用下划线小写风格。
如下： - database_connection.h - database_connection.cpp
结构体，命名空间，枚举等定义的文件名类似。
函数命名
函数命名统一使用大驼峰风格，一般采用动词或者动宾结构。接口部分可加前缀， 如 XXX_函数名。
华为的编程规范和范例
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++)
Function:
// 函数名称
Description: // 函数功能、性能等的描述
Calls:
// 被本函数调用的函数清单
Called By:
// 调用本函数的函数清单
Table Accessed: // 被访问的表（此项仅对于牵扯到数据库操作的程序）
Table Updated: // 被修改的表（此项仅对于牵扯到数据库操作的程序）
n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object );
¹1-6：不允许把多个短语句写在一行中，即一行只写一条语句。 示例：如下例子不符合规范。 rect.length = 0; rect.width = 0;
应如下书写： if (pUserCR == NULL) {
return; }
¹1-8：对齐只使用空格键，不使用TAB键。 说明：以免用不同的编辑器阅读程序时，因 TAB 键所设置的空格数目不同而造成程序布 局不整齐，不要使用 BC 作为编辑器合版本，因为 BC 会自动将 8 个空格变为一个 TAB 键， 因此使用 BC 合入的版本大多会将缩进变乱。
{ ... // program code
}
for (i = 0, j = 0; (i < first_word_length) && (j < second_word_length); i++, j++)
Function:
// 函数名称
Description: // 函数功能、性能等的描述
Calls:
// 被本函数调用的函数清单
Called By:
// 调用本函数的函数清单
Table Accessed: // 被访问的表（此项仅对于牵扯到数据库操作的程序）
Table Updated: // 被修改的表（此项仅对于牵扯到数据库操作的程序）
n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object );
¹1-6：不允许把多个短语句写在一行中，即一行只写一条语句。 示例：如下例子不符合规范。 rect.length = 0; rect.width = 0;
应如下书写： if (pUserCR == NULL) {
return; }
¹1-8：对齐只使用空格键，不使用TAB键。 说明：以免用不同的编辑器阅读程序时，因 TAB 键所设置的空格数目不同而造成程序布 局不整齐，不要使用 BC 作为编辑器合版本，因为 BC 会自动将 8 个空格变为一个 TAB 键， 因此使用 BC 合入的版本大多会将缩进变乱。
华为编程规范与实例
華為編程規範與實例1 排版11-1：程序块要采用缩进风格编写，缩进的空格数为4个。
说明：对于由开发工具自动生成的代码可以有不一致。
11-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;11-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));11-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
华为编程规范
华为编程规范华为是一家世界知名的信息通信技术（ICT）解决方案供应商，为全球超过170个国家和地区的企业和消费者提供产品和服务。
在华为的软件开发过程中，编程规范起着至关重要的作用。
良好的编程规范有助于提高代码的质量和可维护性，减少错误和调试时间，提高开发效率。
以下是华为编程规范的一些核心要点：1. 命名规范：变量、函数、类等命名应具有清晰的含义，并遵循驼峰命名法。
变量和函数名应尽量简短明了，避免使用无意义的名字。
同时，要避免使用拼音或缩写，提高代码的可读性。
2. 注释规范：良好的注释是代码可读性的重要组成部分。
应在需要解释的地方进行注释，对于复杂的算法和逻辑，要详细解释思路和实现方法。
此外，对于代码片段的用途，也可以加上简短的注释。
注释应使用英文，避免使用拼音或其他不常见的语言。
3. 缩进和空格：合理的缩进和空格可以提高代码的可读性。
在华为的编程规范中，使用四个空格作为一个缩进层级。
在运算符和逗号等地方留有适当的空格，使代码更易于阅读。
4. 函数规范：函数应尽量简短，一个函数应有一个明确的目的。
函数命名要具有清晰的语义，能够准确描述函数的功能。
参数应尽量避免过多，遵循最小化设计原则。
5. 异常处理：在代码中应该考虑到可能出现的异常情况，并进行相应的处理。
捕获异常后，应该写明异常类型，并书写明确的处理逻辑。
6. 安全性考虑：在编写代码时，应始终考虑安全性。
避免使用已知存在安全漏洞的函数和方法，对于输入的数据进行合理的校验和过滤，防止代码被恶意攻击者利用。
7. 代码格式化：代码格式化可以提高代码的可读性，使代码更易于维护。
在华为的编程规范中，要求使用一致的缩进和空格，合理分行和对齐，并采用一致的命名风格。
8. 可移植性：考虑到不同平台和操作系统的差异，编写代码时应注重可移植性。
避免使用与操作系统和平台相关的特性和函数，尽量使用标准库和接口。
9. 性能优化：在编写代码时，应注重性能优化。
避免不必要的计算和内存开销，合理选择数据结构和算法。
华为代码规范
华为代码规范=====[ 排版 ]=====11-1：程序块要采用缩进风格编写，缩进的空格数为4个说明：对于由开发工具自动生成的代码可以有不一致。
11-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;11-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));11-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}11-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 );11-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：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
华为c 编码规范,认为比google的好一点
（转）华为c++编码规范，认为比google的好一点–【人人分享目录1、版面... 4 2、命名... 5 3、注释... 6 4、源代码结构... 11 附录A：常见单词缩写表 (12)1、版面【规则1-1】程序块要采用缩进风格编写，缩进的空格数为4个。
【规则1-2】对齐与缩进只使用空格键，不使用TAB键。
说明：以免用不同的编辑器阅读程序时，因TAB键所设置的空格数目不同而造成程序布局不整齐，不要使用会自动将8个空格变为一个TAB键的开发工具编辑代码。
（可开发工具软件自动将TAB键转换为4个空格）【规则1-3】函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case语句下的情况处理语句也要遵从语句缩进要求。
【规则1-4】相对独立的程序块之间、变量说明之后必须加空行（一个空行即可）。
【规则1-5】一行程序以小于80字符为宜，不要写得过长。
【规则1-6】较长的语句（>80字符）要尽量分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。
【规则1-7】循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
【规则1-8】若函数或过程中的参数较长，则要进行适当的划分。
【规则1-9】不允许把多个短语句写在一行中，即一行只写一条语句。
【规则1-10】if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。
【规则1-11】程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。
在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用缩进方式。
华为技术 公司C 语言编程规范
3 函数 ..................................................... 12
3.1 内联函数.............................................................................................................................12 3.2 函数参数.............................................................................................................................13 3.3 函数指针.............................................................................................................................14
0.1 前言 ...................................................................................................................................... 5 0.2 代码总体原则 ....................................................................................................................... 5 0.3 与C语言编程规范的关系 ...................................................................................................... 6 0.4 规范实施、解释....................................................................................................................6 0.5 术语定义...............................................................................................................................6
3.1 内联函数.............................................................................................................................12 3.2 函数参数.............................................................................................................................13 3.3 函数指针.............................................................................................................................14
0.1 前言 ...................................................................................................................................... 5 0.2 代码总体原则 ....................................................................................................................... 5 0.3 与C语言编程规范的关系 ...................................................................................................... 6 0.4 规范实施、解释....................................................................................................................6 0.5 术语定义...............................................................................................................................6
华为C++语言通用编程规范.pdf
我们可以通过约束这些特性的使用，或者使用 C++的新特性，比如 variant(C++17)， GSL 的 span，narrow_cast 等来解决这些问题，提高 C++代码的健壮性。
遵循 C++ ISO 标准
希望通过使用 ISO C++标准的特性来编写 C++代码，对于 ISO 标准中未定义的或者 编译器实现的特性要谨慎使用，对于 GCC 等编译器的提供的扩展特性也需要谨慎 使用，这些特性会导致代码的可移植性比较差。
保证静态类型安全
我们希望 C++应该是静态类型安全的，这样可以减少运行时的错误，提高代码的健 壮性。但是由于 C++的下面的特性存在，会破坏 C++静态类型安全，我们针对这部 分特性要仔细处理。 - unions 联合体 - 类型转换 cast - 缩窄转换 narrowing conversions - 类型退化 type decay - 范围错误 range errors - void*类型指针
• 通过 const 来保证数据的不变性，防止数据被无意修改。 • 通过 gsl::span 等来保证 char 数组不越界，而不是通过运行时的 length 检查。 • 通过 static_assert 来进行编译时检查。
使用命名空间来限定作用域
全局变量，全局常量和全局类型定义由于都属于全局作用域，在项目中，使用第三 方库中容易出现冲突。
注意：如果模块中需要使用相关的扩展特性来，那么尽可能将这些特性封装成独立 的接口，并且可以通过编译选项关闭或者编译这些特性。对于这些扩展特性的使用， 请模块制定特性编程指南来指导这些特性的使用。
遵循 C++ ISO 标准
希望通过使用 ISO C++标准的特性来编写 C++代码，对于 ISO 标准中未定义的或者 编译器实现的特性要谨慎使用，对于 GCC 等编译器的提供的扩展特性也需要谨慎 使用，这些特性会导致代码的可移植性比较差。
保证静态类型安全
我们希望 C++应该是静态类型安全的，这样可以减少运行时的错误，提高代码的健 壮性。但是由于 C++的下面的特性存在，会破坏 C++静态类型安全，我们针对这部 分特性要仔细处理。 - unions 联合体 - 类型转换 cast - 缩窄转换 narrowing conversions - 类型退化 type decay - 范围错误 range errors - void*类型指针
• 通过 const 来保证数据的不变性，防止数据被无意修改。 • 通过 gsl::span 等来保证 char 数组不越界，而不是通过运行时的 length 检查。 • 通过 static_assert 来进行编译时检查。
使用命名空间来限定作用域
全局变量，全局常量和全局类型定义由于都属于全局作用域，在项目中，使用第三 方库中容易出现冲突。
注意：如果模块中需要使用相关的扩展特性来，那么尽可能将这些特性封装成独立 的接口，并且可以通过编译选项关闭或者编译这些特性。对于这些扩展特性的使用， 请模块制定特性编程指南来指导这些特性的使用。
华为编程规范
〔一〕=====[排版] ]=======......................................................................... 〔二〕======[注释]=======......................................................................... 〔三〕=====[标识符命名]======= .................................................................. 〔四〕=====[可读性]====== .......................................................................... 〔五〕=====[变量、结构]=====....................................................................... 〔六〕=====[函数、过程]=====....................................................................... 〔七〕=====[可测性]=====............................................................................. 〔八〕=====[程序效率]=====.......................................................................... 〔九〕=====[质量保证]=====.......................................................................... 〔十〕=====[代码编辑、编译、审查]=====......................................................... 〔十一〕=====[代码测试、维护]=====............................................................... 〔十二〕=====[宏]===== ...............................................................................〔一〕=====[排版]¹1-1：程序块要采用缩进风格编写，缩进的空格数为4个说明：对于由开发工具自动生成的代码可以有不一致。
C_C++编程规范-华为标准-精
值范围及公共变量间的关系。 5-3：明确公共变量与操作此公共变量的函数或过
程的关系，如访问、修改及创建等。 5-4：当向公共变量传递数据时，要十分小心，防
止赋与不合理的值或越界等现象发生。 5-5：防止局部变量与公共变量同名。 5-6：严禁使用未经初始化的变量作为右值。
编程规范详解——函数、过程 处理。
1-11：在两个以上的关键字、变量、常量进行对等操作时，它们之间 的操作符之前、之后或者前后要加空格；进行非对等操作时，如果 是关系密切的立即操作符（如－>），后不应加空格。
1-12: 程序结构清析，简单易懂，单个函数的程序行数不得超过100行。
编程规范详解——注释
2-1：一般情况下，源程序有效注释量必须在20％以上。 2-2：说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg
编程规范详解——注释
2-9：对于所有有物理含义的变量、常量，如果其命名不是充分自注释的，在 声明时都必须加以注释，说明其物理含义。变量、常量、宏的注释应放在 其上方相邻位置或右方。
2-10：数据结构声明(包括数组、结构、类、枚举等)，如果其命名不是充分自 注释的，必须加以注释。对数据结构的注释应放在其上方相邻位置，不可 放在下面；对结构中的每个域的注释放在此域的右方。
后进入下一个case处理，必须在该case语句处理完、下一个case语句前加 上明确的注释。
编程规范详解——标识符的命名
3-1：标识符的命名要清晰、明了，有明确含义，同时使用完 整的单词或大家基本可以理解的缩写，避免使人产生误解。
3-2：命名中若使用特殊约定或缩写，则要有注释说明 3-3：自己特有的命名风格，要自始至终保持一致，不可来回
延用华为标准
C/C++编程规范
程的关系，如访问、修改及创建等。 5-4：当向公共变量传递数据时，要十分小心，防
止赋与不合理的值或越界等现象发生。 5-5：防止局部变量与公共变量同名。 5-6：严禁使用未经初始化的变量作为右值。
编程规范详解——函数、过程 处理。
1-11：在两个以上的关键字、变量、常量进行对等操作时，它们之间 的操作符之前、之后或者前后要加空格；进行非对等操作时，如果 是关系密切的立即操作符（如－>），后不应加空格。
1-12: 程序结构清析，简单易懂，单个函数的程序行数不得超过100行。
编程规范详解——注释
2-1：一般情况下，源程序有效注释量必须在20％以上。 2-2：说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg
编程规范详解——注释
2-9：对于所有有物理含义的变量、常量，如果其命名不是充分自注释的，在 声明时都必须加以注释，说明其物理含义。变量、常量、宏的注释应放在 其上方相邻位置或右方。
2-10：数据结构声明(包括数组、结构、类、枚举等)，如果其命名不是充分自 注释的，必须加以注释。对数据结构的注释应放在其上方相邻位置，不可 放在下面；对结构中的每个域的注释放在此域的右方。
后进入下一个case处理，必须在该case语句处理完、下一个case语句前加 上明确的注释。
编程规范详解——标识符的命名
3-1：标识符的命名要清晰、明了，有明确含义，同时使用完 整的单词或大家基本可以理解的缩写，避免使人产生误解。
3-2：命名中若使用特殊约定或缩写，则要有注释说明 3-3：自己特有的命名风格，要自始至终保持一致，不可来回
延用华为标准
C/C++编程规范
华为技术有限公司C语言编程规范
confidentialityleveldkba2826201150规范制订说明01前言为提高产品代码质量指导广大软件开发人员编写出简洁可维护可靠可测试高效可移植的代码编程规范修订工作组分析总结了我司的各种典型编码问题并参考了业界编程规范近年来的成果重新对我司1999年版编程规范进行了梳理优化刷新编写了本规范
DKBA
华为技术有限公司内部术规范
DKBA 2826-2011.5
C语言编程规范
2011年5月9日发布
2011年5月9日实施
华为技术有限公司 Huawei Technologies Co., Ltd.
版权所有 侵权必究 All rights reserved
密级：内部公开DKBA 2826-2011.5
修订声明Revision declaration
本规范拟制与解释部门：
本规范的相关系列规范或文件： 相关国际规范或文件一致性： 替代或作废的其它规范或文件： 相关规范或文件的相互关系：
规范号 DKBAxxxx.x-xxxx.xx
主要起草部门专家 PSST质量部： 郭曙光00121837 网络： 张伟00118807 周灿00056781 王晶00041937 陈艺彪00036913 IP开发部： 薛治00038309 核心网： 张小林00058208 王德喜00040674 李明胜00042021 软件公司： 文 滔00119601 无线： 刘爱华00162172 中研： 谭洪00162654
主要评审部门专家 PSST质量部： 李重霄00117374 郭永生00120218 核心网： 张进柏00120359 中研： 张建保00116237 无线： 苏光牛00118740 郑铭00118617 陶永祥00120482 软件公司： 周代兵00120359 刘心红00118478 朱文琦00172539 网络： 王玎00168059 黄维东49827 IP开发部： 饶远00152313
DKBA
华为技术有限公司内部术规范
DKBA 2826-2011.5
C语言编程规范
2011年5月9日发布
2011年5月9日实施
华为技术有限公司 Huawei Technologies Co., Ltd.
版权所有 侵权必究 All rights reserved
密级：内部公开DKBA 2826-2011.5
修订声明Revision declaration
本规范拟制与解释部门：
本规范的相关系列规范或文件： 相关国际规范或文件一致性： 替代或作废的其它规范或文件： 相关规范或文件的相互关系：
规范号 DKBAxxxx.x-xxxx.xx
主要起草部门专家 PSST质量部： 郭曙光00121837 网络： 张伟00118807 周灿00056781 王晶00041937 陈艺彪00036913 IP开发部： 薛治00038309 核心网： 张小林00058208 王德喜00040674 李明胜00042021 软件公司： 文 滔00119601 无线： 刘爱华00162172 中研： 谭洪00162654
主要评审部门专家 PSST质量部： 李重霄00117374 郭永生00120218 核心网： 张进柏00120359 中研： 张建保00116237 无线： 苏光牛00118740 郑铭00118617 陶永祥00120482 软件公司： 周代兵00120359 刘心红00118478 朱文琦00172539 网络： 王玎00168059 黄维东49827 IP开发部： 饶远00152313
华为CC语言编程规范
百度文库- 让每个人平等地提升自我目录1 排版 (2)4 可读性 (11)6 函数、过程 (13)7 可测性 (14)1 排版¹1-1：程序块要采用缩进风格编写，缩进的空格数为4个。
说明：对于由开发工具自动生成的代码可以有不一致。
¹1-2：相对独立的程序块之间、变量说明之后必须加空行。
示例：如下例子不符合规范。
if (!valid_ni(ni)){... epssn_index;repssn_ni = ssn_data[index].ni;应如下书写if (!valid_ni(ni)){... epssn_index;repssn_ni = ssn_data[index].ni;¹1-3：较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。
示例：= 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：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
华为的编程规范和范例
目录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：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
华为C语言编程规范.
... // program code }
if (...) {
... // program code }
void example_fun( void ) {
¹1-2：相对独立的程序块之间、变量说明之后必须加空行。 示例：如下例子不符合规范。 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;
示例：
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;
¹1-6：不允许把多个短语句写在一行中，即一行只写一条语句。 示例：如下例子不符合规范。 rect.length = 0; rect.width = 0;
应如下书写
仅供内部使用 4
软件编程规范总则
1 排版
rect.length = 0; rect.width = 0;
¹1-7：if、for、do、while、case、switch、default等语句自占一行，且if、for、
¹1-9：函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case 语句下的情况处理语句也要遵从语句缩进要求。
¹1-10：程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一 列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以 及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。
if (...) {
... // program code }
void example_fun( void ) {
¹1-2：相对独立的程序块之间、变量说明之后必须加空行。 示例：如下例子不符合规范。 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;
示例：
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;
¹1-6：不允许把多个短语句写在一行中，即一行只写一条语句。 示例：如下例子不符合规范。 rect.length = 0; rect.width = 0;
应如下书写
仅供内部使用 4
软件编程规范总则
1 排版
rect.length = 0; rect.width = 0;
¹1-7：if、for、do、while、case、switch、default等语句自占一行，且if、for、
¹1-9：函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case 语句下的情况处理语句也要遵从语句缩进要求。
¹1-10：程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一 列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以 及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。
华为c语言编程规范
华为c语言编程规范华为C语言编程规范1. 命名规范：- 变量、函数、宏名使用小写字母和下划线的组合，如：int my_variable;- 宏名全部大写，并用下划线分隔单词，如：#defineMAX_NUM 100;- 结构体命名使用大驼峰命名法，如：typedef struct MyStruct; - 文件名使用小写字母和下划线的组合，如：my_file.c;2. 缩进与换行：- 使用4个空格进行缩进，不使用Tab键；- 换行时，尽量将操作符放在新行开头，如：a = b +c;- if、for、while等关键字后的括号与关键字之间不换行；- 如果一行超过80个字符，应该进行换行；3. 注释规范：- 使用//进行单行注释；- 使用/**/进行多行注释；- 对代码的重点或逻辑进行注释，并保持注释和代码同步更新；- 不使用无意义的注释；4. 函数与变量规范：- 函数应该具有明确的功能，并使用动词开头；- 变量必须在使用前进行声明，并尽量减少全局变量的使用； - 变量名应该具有描述性，并易于理解；- 不要使用具有歧义或过于简单的变量名；- 变量应该在定义的同时初始化；5. 语法与逻辑规范：- 不要在一个语句中定义多个变量；- 避免使用goto语句；- 比较变量和常量时，应该将变量放在前面，如：if (x == 0); - 不要使用宏定义来替换函数，除非替换后代码不被执行；- 返回值应该使用明确的类型，避免使用int类型表示布尔值； - 使用语言提供的错误处理机制，不要使用全局变量进行错误处理；6. 引入外部文件规范：- 头文件的引用应该尽可能放在源文件的开头；- 头文件的引用应该使用""而不是<>，以示区分；- 头文件的引用应该避免循环引用；- 不要在头文件中定义变量；以上是华为C语言编程规范的部分内容，为了提高代码的可读性和可维护性，开发者应该严格遵守这些规范。
这些规范不仅适用于华为的开发项目，也适用于其他的C语言开发项目。
华为编程规范与实例
華為編程規範與實例1 排版11-1：程序块要采用缩进风格编写，缩进的空格数为4个。
说明：对于由开发工具自动生成的代码可以有不一致。
11-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;11-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));11-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
act_task_table[taskno].duration_true_or_false = SYS_get_sccp_statistic_state( stat_item );
report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)
仅供内部使用
2
软件编程规范总则
示例： (1) 逗号、分号只在后面加空格。 int a, b, c;
仅供内部使用
6
软件编程规范总则
1 排版
(2)比较操作符, 赋值操作符"="、 "+="，算术操作符"+"、"%"，逻辑操作符"&&"、 "&"，位域操作符"<<"、"^"等双目操作符的前后加空格。 if (current_time >= MAX_TIME_VALUE) a = b + c; a *= 2; a = b ^ 2;
仅供内部使用
7
软件编程规范总则
2 注释
2 பைடு நூலகம்释
¹2-1：一般情况下，源程序有效注释量必须在20％以上。 说明：注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不 能太少，注释语言必须准确、易懂、简洁。 ¹2-2：说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应 进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的 关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要 包含在内。 /************************************************* Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. File name: Author: Description: // 文件名 Version: Date: // 作者、版本及完成日期
1 排版
&& (n7stat_stat_item_valid (stat_item)) && (act_task_table[taskno].result_data != 0));
仅供内部使用
3
软件编程规范总则
1 排版
¹1-4：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低 优先级操作符处划分新行，操作符放在新行之首。 示例： if ((taskno < max_act_task_number) && (n7stat_stat_item_valid (stat_item))) { ... // program code }
<author> <time> David 96/10/12
build this moudle
***********************************************************/ 说明：Description 一项描述本文件的内容、功能、内部各部分之间的关系及本文件与 其它文件关系等。History 是修改历史记录列表，每条修改记录应包括修改日期、修改 者及修改内容简述。 ¹2-4：函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返回值、调用 关系（函数、表）等。 示例：下面这段函数的注释比较标准，当然，并不局限于此格式，但上述信息建议要包含 在内。 /************************************************* Function: Description: Calls: Called By: // 函数名称 // 函数功能、性能等的描述 // 被本函数调用的函数清单 // 调用本函数的函数清单
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 );
应如下书写： if (pUserCR == NULL) { return; } ¹1-8：对齐只使用空格键，不使用TAB键。 说明： 以免用不同的编辑器阅读程序时， 因 TAB 键所设置的空格数目不同而造成程序布局 不整齐，不要使用 BC 作为编辑器合版本，因为 BC 会自动将 8 个空格变为一个 TAB 键， 因此使用 BC 合入的版本大多会将缩进变乱。 ¹1-9：函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case 语句下的情况处理语句也要遵从语句缩进要求。 ¹1-10：程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一 列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以 及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 示例：如下例子不符合规范。 for (...) { ... // program code }
目
1 排版 2 注释 3 标识符命名 4 可读性 5 变量、结构 6 函数、过程 7 可测性 8 程序效率 9 质量保证 10 代码编辑、编译、审查 11 代码测试、维护 12 宏
录
6 11 18 20 22 28 36 40 44 50 52 53
软件编程规范总则
1 排版
1 排版
¹1-1：程序块要采用缩进风格编写，缩进的空格数为4个。 说明：对于由开发工具自动生成的代码可以有不一致。 ¹1-2：相对独立的程序块之间、变量说明之后必须加空行。 示例：如下例子不符合规范。 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;
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：若函数或过程中的参数较长，则要进行适当的划分。 示例：
Table Accessed: // 被访问的表（此项仅对于牵扯到数据库操作的程序） Table Updated: // 被修改的表（此项仅对于牵扯到数据库操作的程序） Input: // 输入参数说明，包括每个参数的作 // 用、取值说明及参数间关系。 Output: Return: Others: // 对输出参数的说明。 // 函数返回值的说明 // 其它说明
(4)"->"、"."前后不加空格。 p->id = pid; // "->"指针前后不加空格
(5) if、for、while、switch 等与后面的括号间应加空格，使 if 等关键字更为突出、 明显。 if (a >= b && c > d) ½1-1：一行程序以小于80字符为宜，不要写得过长。
(3)"!"、"~"、"++"、"--"、"&"（地址运算符）等单目操作符前后不加空格。 *p = 'a'; // 内容操作"*"与内容之间
flag = !isEmpty; // 非操作"!"与内容之间 p = &mem; i++; // 地址操作"&" 与内容之间 // "++","--"与内容之间
仅供内部使用
8
软件编程规范总则
2 注释
/************************************************************ Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. FileName: test.cpp Author: Description: Version: Function List: 1. ------History: // 历史修改记录 <version > 1.0 <desc> Version : // 模块描述 // 版本信息 // 主要函数及其功能 Date:
void example_fun( void ) { ... // program code } ¹1-11：在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或 者前后要加空格；进行非对等操作时，如果是关系密切的立即操作符（如－>），后不应加空 格。 说明：采用这种松散方式编写代码的目的是使代码更加清晰。 由于留空格所产生的清晰性是相对的， 所以， 在已经非常清晰的语句中没有必要再留空格， 如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格， 多重括号间 不必加空格，因为在 C/C++语言中括号已经是最清晰的标志了。 在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。给 操作符留空格时不要连续留两个以上空格。