华为公司软件编程规范.doc

目 录
1　排版
6
2 注释
１１
3　标识符命名
18
4 可读性
２0
５ 变量、结构
2２
6 函数、过程
28
7 可测性
36
８ 程序效率
40
9 质量保证
44
10 代码编辑、编译、审查
５0
11　代码测试、维护
52
1２　宏
53
1 排版
1—1：程序块要采用缩进风格编写，缩进的空格数为4个。
说明:对于由开发工具自动生成的代码可以有不一致.
１-2：相对独立的程序块之间、变量说明之后必须加空行。
示例:如下例子不符合规范。
if （！vａlｉｄ_ni(ni））
｛
　．.。 //　ｐrograｍ codｅ
}
reｐｓsn_ind =　ｓsn_data[index］。repssn_ｉndex;
repssn＿ｎｉ =　sｓn_data［inｄex].ni;
应如下书写
if (!ｖalid_ni（ni))
{
　　 　。．。 ／／ ｐrogｒaｍ cｏde
}
ｒepsｓn_ind = ｓsn_ｄata［index].repssn＿inｄex；
reｐssn＿ni =　ｓｓｎ_ｄatａ［indｅx］．ni;
1-3:较长的语句（〉80字符)要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。
示例：
pｅｒｍ＿counｔ_msｇ。 = NO7_TＯ_SＴAT＿PERM_ＣＯUNＴ＿LEＮ
　 　　 　 　 ＋ SＴＡＴ_SIZＥ_PER＿ＦＲAM ＊　sizeof(　＿UL　）;
aｃt_task_ｔａble[framｅ_id ＊ STＡT＿TＡSＫ_CHECK＿ＮUMBER + ｉndｅx].ｏｃcuｐieｄ
　 　 　 = stat_poi［index]。ｏｃcuｐied;
aｃt_tａsk＿ｔable[tａskｎo］。duraｔion_tｒue_oｒ_false
　 = SYS_geｔ_ｓccp_sｔaｔistic_statｅ（ staｔ＿item ）；
reｐort_ｏｒ_not_flag = （（taskｎo <　ＭＡＸ_ACT_TASK＿NＵMBER）
　 　 　　　　 &＆　(n7sｔat_staｔ_itｅｍ_vａlｉd (staｔ_iteｍ)）
　 　　 &＆　（act_tａsk_tａbｌｅ[ｔaｓｋno].ｒeｓult_datａ　!＝ 0）);
ﻬ1-４:循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
示例:
iｆ (（taskno 〈　max_act_task_nuｍｂer)
＆& (n７ｓtat_sｔat_item_vaｌｉd （ｓtａt_itｅm)))
{
　 　.。。　／/　ｐrogrａm code
}
for （i = 0， j = 0; (i ＜ BｕfferKeyworｄ[ｗoｒd＿iｎdeｘ]。woｒd_ｌength)
　　 　 ＆& (j < ）； i+＋， ｊ++）
{
　 .。。　// ｐroｇｒａm　cｏde
}
for (i =　０,　ｊ = 0;
　 (i 〈 fiｒst_wｏrd＿lenｇth） && （ｊ　< seｃｏnd_wｏrd_lｅnｇth)；
i++,　j++)
{
。.。 // pｒｏgram ｃodｅ
｝
1－5：若函数或过程中的参数较长，则要进行适当的划分。
示例：
ｎ7ｓtat_str_compare（（BYＴE ＊) & stat_objecｔ,
　 　　　　 　　 （BYTＥ　＊） & (ａct_task_tａｂlｅ［taskｎo］。stat_objｅcｔ）,
　 　　 　 　 　sｉzｅof (_ＳTＡT＿ＯＢJECＴ));
n７ｓtat_ｆlash_ａct_ｄurａｔioｎ（ stat＿ｉtem, fｒamｅ＿id　*SＴAＴ_TASＫ_CHEＣＫ_ＮUＭＢEＲ
　 　 　 　 + ｉnｄex，　stat_object )；
1-6:不允许把多个短语句写在一行中,即一行只写一条语句。
示例:如下例子不符