软件编程规范总则(doc 59页)

软件编程规范总则目录：
1、排版
2、注释
3、标识符命名
4、可读性
5、变量、结构
6、函数、过程
7、可测性
8、程序效率
9、质量保证
10、代码编辑、编译、审查
11、代码测试、维护
12、宏

 

软件编程规范总则内容简介：
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;
应如下书写
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：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。

..............................