C语言编程规范2: 排版

    我们不仅要写高效的代码，还要写可读性很强的代码，随着我们所开发系统的复杂性的不断提高，这就要求我们所写的程序具有3个特性：1、可读性；2、可多人协作性；3、可移植性。但是，像我们这样电子专业毕业的学生，都没有接受过“软件设计方法论”、“操作系统原理”等课程的深入训练，这就使我们所写的程序与软件专业工程师所写的程序具有较大的差距，这些问题使得公司在程序的代码维护上面临着诸多的困难。这种窘境需要打破！

    本文从“C语言编程规范”着手，着重讲授如何书写规范性的C语言程序代码，文中所举实例，均为知名公司所采用的C语言规范。按照本系列课程严格要求自己规范性编写C语言代码，可使得我们书写的程序给人耳目一新的感觉，易于阅读，并避免潜在的逻辑性错误的发生。

    排版：

    ①程序块要采用缩进风格编写，缩进的空格数为 4 个。把源程序中的Tab字符转换成4个空格；一个缩进等级（Indentation Level）是4个空格；变量定义和可执行语句要缩进一个等级；函数的参数过长时，也要缩进。

    ②程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 例如：

for (...)

{

... // program code

}

if (...)

{

... // program code

}

void example_fun( void )

{

... // program code

}

③相对独立的程序块之间、变量说明之后必须加空行。

if (!valid_ni(ni))

{

... // program code

}

repssn_ind = ssn_data[index].repssn_index;

repssn_ni = ssn_data[index].ni;

④不允许把多个短语句写在一行中，即一行只写一条语句。

rect.length = 0;

rect.width = 0;

⑤if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。

if (pUserCR == NULL)

{

    return;

}

⑥函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case语句下的情况处理语句也要遵从语句缩进要求。

⑦在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或者前后要加空格；进行非对等操作时，如果是关系密切的立即操作符（如－>），后不应加空格。 说明：采用这种松散方式编写代码的目的是使代码更加清晰。 由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必要再留空格，如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格，多重括号间不必加空格，因为在C语言中括号已经是最清晰的标志了。 在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。给操作符留空格时不要连续留两个以上空格。