C语言编码规范.docx

可编辑可修改
语言编程规范
对于程序员来说，能工作的代码并不等于“好”的代码。 “好”代码的指标很多，包括易
读、易维护、易移植和可靠等。其中，可靠性对嵌入式系统非常重要，尤其是在那些对安全
80 字符宽的终端屏
幕上看着很不舒服。对这个问题的回答是：如果你有超过 3 个级别的缩进，你就有点犯糊涂了，应当修改你的程序。简而言之， 8 个字符的缩进使程序更易读，而且当你把功能隐藏的太深时，多层次的缩进还会对此很直观的给出警告。要留心这种警告信息。
例外：对于由开发工具自动生成的代码可以有不一致。
33
可编辑可修改
及时折行
较长的语句 (>80 字符 ) 要分成多行书写，长表达式要在低优先级操作符处划分新行，操
作符放在新行之首，划分出的新行要进行适当的缩进 ( 至少 1 个 TAB位置 ) ，使排版整齐，语
句可读。示例：
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 );
一行只写一条语句
不允许把多个短语句写在一行中，即一行只写一条语句。示例，如下例子不符合规范：
=0; =0;
应如下书写
0;
0;
44
可编辑可修改
if 、 for 、do、 while 等语句格式规定
if 、 for 、do 、 while 、case 、 switch 、default 等语句自占一行，且 if 、for 、
do 、while 等语句的执行语句部分无论多少都要加花括号 {} 。
空行
变量说明之后必须加空行。
相对独立的程序块之间应加空行。
空格
在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或者
前后要加空格；进行非对等操作时，如果是关系密切的立即操作符 ( 如－ > ) ，后不应加空格。
采用这种松散方式编写代码的目的是使代码更加清晰。
由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必要再留空
格，如果语句已足够清晰则括号内侧 ( 即左括号后面和右括号前面 ) 不需要加空格，多重括号
间不必加空格，因为在 C/C++语言中括号已经是最清晰的标志了。
在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。
给操作符留空格时不要连续留两个以上空格。
逗号、分号只在后面加空格。
int a, b, c;
比较操作符 , 赋值操作符 "=" 、 "+=" ，算术操作符 "+" 、"%"，逻辑操作符 "&&"、"&" ，位域操作符 "<<" 、"^" 等双目操作符的前后加空格。
if (current_time >= MAX_TIME_VALUE)
{
a = b + c;
}
a *= 2;
a = b ^ 2;
55
可编辑可修改
(3)"!" 、"~" 、 "++" 、 "--" 、 "&"( 地址运算符 ) 等单目操作符前后不加空格。
*p = 'a'; 前后不加空格。
p->id = pid; epssn_index;
repss