1、为软件编程规范和范例 一=排版 = .二=注释= .三=标识符命名 = .四=可读性 = .五=变量、结构 =.六=函数、过程 =.七=可测性 = .八=程序效率 =.九=质量保证 =.十=代码编辑、编译、审查= .十一= 代码测试、维护= .十二= 宏= .一 = 排版 1-1 :程序块要采用缩进风格编写,缩进的空格数为 4 个 说明:对于由开发工具自动生成的代码可以有不一致。 1-2 :相对独立的程序块之间、变量说明之后必须加空行 示例:如下例子不符合规范。 if (!valid_ni(ni). / program coderepssn_ind = ssn_dataindex.repssn
2、_index;repssn_ni = ssn_dataindex.ni; 应如下书写 if (!valid_ni(ni). / program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;1-3 :较长的语句(80 字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读 示例: perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRA
3、M * sizeof( _UL );act_task_tableframe_id * STAT_TASK_CHECK_NUMBER + index.occupied= stat_poiindex.occupied;act_task_tabletaskno.duration_true_or_false= SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = (taskno ),后不应加空格。 说明:采用这种松散方式编写代码的目的是使代码更加清晰 由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格,
4、如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在 C/C+语言中括号已经是最清晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给操作符留空格时不要连续留两个以上空格。 示例: (1) 逗号、分号只在后面加空格。int a, b, c; (2)比较操作符, 赋值操作符“=“、 “+=“,算术操作符“+“、“%“,逻辑操作符“a *= 2;a = b 2; (3)“!“、“、“+“、“-“、“ / 内容操作“*“与内容之间flag = !isEmpty; / 非操作“!“与内容之间p = / 地址操作“ /
5、“+“,“-“与内容之间(4)“-“、“.“前后不加空格。p-id = pid; / “-“指针前后不加空格(5) if、for、while、switch 等与后面的括号间应加空格,使 if 等关键字更为突出、明显。if (a = b repssn_ni = ssn_dataindex.ni; 例 2:repssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;/* get replicate sub system index and net indicator */ 应如下书写 /* get replicate sub system index and net indicator */repssn_ind = ssn_dataindex.repssn_index;