文档介绍：该【华为代码规范文档】是由【雨林书屋】上传分享，文档一共【34】页，该文档可以免费在线阅读，需要了解更多关于【华为代码规范文档】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。精选文档
精选文档
精选文档

代码规范文档
1
精选文档
精选文档
精选文档

目录
1
概括...................................................................................................................................................................
3

编写目的...........................................................................................................................................
3

文档商定...........................................................................................................................................
3

预期的读者和阅读建议...................................................................................................................
3

参照文件...........................................................................................................................................
3
2
排版要求
...........................................................................................................................................................
4

程序块缩进.......................................................................................................................................
4

程序块之间空行...............................................................................................................................
4

长语句和长表达式...........................................................................................................................
4

循环、判断等长表达式或语句.......................................................................................................
5

短语句...............................................................................................................................................
6

条件、循环语句...............................................................................................................................
6

语句对齐...........................................................................................................................................
6

函数、过程和结构等语句块
7
精选文档
精选文档
精选文档
...........................................................................................................

程序块分界符...................................................................................................................................
7

说明性文件.......................................................................................................................................
8

源文件头...........................................................................................................................................
8

变量、常量说明...............................................................................................................................
9

数据结构的说明...............................................................................................................................
9

全局变量.........................................................................................................................................
10

其余.................................................................................................................................................
10

命名规范与系统风格一致.............................................................................................................
12

其余.................................................................................................................................................
12
3
可读性.............................................................................................................................................................
14

运算符优先级.................................................................................................................................
14

防止直接使用数字作为表记符.....................................................................................................
14
4
函数、过程.....................................................................................................................................................
16

对所调用函数的错误返回码要认真、全面地办理。..................................................................
16
精选文档
精选文档
精选文档

明确函数功能,精准(而不是近似)地实现函数设计。..........................................................
16

局部变量.........................................................................................................................................
16

全局变量.........................................................................................................................................
16
5
可测性.............................................................................................................................................................
17

调测开关.........................................................................................................................................
17

打印信息.........................................................................................................................................
17

单元测试.........................................................................................................................................
17

集成测试.........................................................................................................................................
17

断言使用.........................................................................................................................................
18

使用宏时,不一样意参数发生变化.................................................................................................
20
精选文档
精选文档
精选文档
2
精选文档
精选文档
精选文档

概括

为规范软件开发人员的代码编写供给参照依照和一致标准。

说明本文档中所用到的专用术语定义或解说,缩略词定义。

本文档合用于全部软件开发人员。

列出相关的参照文件,如:
.属于本项目的其余已发布文件;
.本文件中各处引用的文档资料。
列出这些文件的标题、作者,说明能够获取这些文件资料的根源。
精选文档
精选文档
精选文档
3
精选文档
精选文档
精选文档

排版要求

程序块要采纳缩进风格编写,缩进的空格数为4个。
说明:关于由开发工具自动生成的代码能够有不一致。

相对独立的程序块之间、变量说明以后一定加空行。
示例:以下例子不切合规范。
if(!valid_ni(ni))
{
...epssn_index;
repssn_ni=ssn_data[index].ni;
应以下书写
if(!valid_ni(ni))
{
...epssn_index;
repssn_ni=ssn_data[index].ni;

较长的语句(>80字符)要分红多行书写,长表达式要在低优先级操作符处区分新行,操作符放在新
行之首,区分出的新行要进行适合的缩进,使排版齐整,语句可读。
示例:
NO7_TO_STAT_PERM_COUNT_LEN
STAT_SIZE_PER_FRAM*sizeof(_UL);
精选文档
精选文档
精选文档
4
精选文档
精选文档
精选文档

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));
、判断等长表达式或语句
循环、判断等语句中如有较长的表达式或语句,则要进行适应的区分,长表达式要在低优先级操作符
处区分新行,操作符放在新行之首。
示例:
if((taskno<max_act_task_number)
&&(n7stat_stat_item_valid(stat_item)))
{
...ord_length)
&&(j<;i++,j++)
{
....tat_object),
sizeof(_STAT_OBJECT));
n7stat_flash_act_duration(stat_item,frame_id*STAT_TASK_CHECK_NUMBER
+index,stat_object);
精选文档
精选文档
精选文档
精选文档
精选文档
精选文档
5
精选文档
精选文档
精选文档

不一样意把多个短语句写在一行中,即一行只写一条语句。
示例:以下例子不切合规范。
=0;=0;
应以下书写
0;
0;
、循环语句
if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执
行语句部分不论多少都要加括号{}。
示例:以下例子不切合规范。
if(pUserCR==NULL)return;
应以下书写:
if(pUserCR==NULL)
{
return;
}

对齐只使用空格键,不使用TAB键。
说明:免得用不一样的编写器阅读程序时,因TAB键所设置的空格数量不一样而造成程序布局不齐整,
不要使用BC作为编写器合版本,因为BC会自动将8个空格变成一个TAB键,所以使用BC合入的版本大
多会将缩进事变。
精选文档
精选文档
精选文档
6
精选文档
精选文档
精选文档

、过程和结构等语句块
函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采纳缩进风格,case语句下的状况
办理语句也要遵照语句缩进要求。

程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行而且位于同一列,同时与引用
它们的语句左对齐。在函数体的开始、类的定义、结构的定义、列举的定义以及if、for、do、while、switch、
case语句中的程序都要采纳如上的缩进方式。
示例:以下例子不切合规范。
for(...){
....)
{
.....)
{
....)
{
....前后不加空格。
p->id=pid;Allmanufacturing,reproduction,use,*/
/*andsalesrightspertainingtothissubjectmatteraregovernedbythe*/
/**/
/*thetermsofthe
license.
*/
/*本软件文档资料是xxx企业的财产,任何人士阅读和使用本资料一定获取*/
/*相应的书面受权,担当保密责任和接受相应的法律约
束.*/
精选文档
精选文档
精选文档