| Comments

C语言的缩进和空白

C语言的缩进和空白使用原则

一般编码缩进规则

1.字if、while、for与其后的控制表达式的(括号之间插入一个空格分隔，但括号内的表达式应紧贴括号 例如 while (1) 2.双目运算符的两侧各插入一个空格分隔，单目运算符和操作数之间不加空格 例如： i␣=␣i␣+␣1、++i、!(i␣<␣1)、-x、&a[1]等)

3.后缀运算符和操作数之间也不加空格 例如: 取结构体成员s.a、函数调用foo(arg1)、取数组成员a[i]

  1. ,号和;号之后要加空格，这是英文的书写习惯 例如： for␣(i␣=␣1;␣i␣<␣10;␣i++)、foo(arg1,␣arg2)

  2. 有时候为了突出优先级也可以写得更紧凑一些 例如： for␣(i=1;␣i<10;␣i++)、distance␣=␣sqrt(xx␣+␣yy)等。但是省略的空格一定不要误导了读代码的人，例如a||b␣&&␣c很容易让人理解成错误的优先级.

  3. 接近或大于80个字符的较长语句要折行写 由于UNIX系统标准的字符终端是24行80列的，接近或大于80个字符的较长语句要折行写，折行后用空格和上面的表达式或参数对齐，例如：

1
2
3

if␣(sqrt(x*x␣+␣y*y)␣>␣5.0
    &&␣x␣<␣0.0
    &&␣y␣>␣0.0)

再比如：

1
2

foo(sqrt(x*x␣+␣y*y),
    a[i-1]␣+␣b[i-1]␣+␣c[i-1])
  1. 较长的字符串可以断成多个字符串然后分行书写 例如:
1
2

printf("This is such a long sentence that "
       "it cannot be held within a line\n");

C编译器会自动把相邻的多个字符串接在一起，以上两个字符串相当于一个字符串”This is such a long sentence that it cannot be held within a line\n”。

  1. 在变量定义语句中用Tab字符，使变量名对齐 有的人喜欢在变量定义语句中用Tab字符，使变量名对齐，这样看起来很美观。

内核编码缩进规则

1.要用缩进体现出语句块的层次关系 要用缩进体现出语句块的层次关系，使用Tab字符缩进，不能用空格代替Tab。在标准的字符终端上一个Tab看起来是8个空格的宽度，如果你的文本编辑器可以设置Tab的显示宽度是几个空格，建议也设成8，这样大的缩进使代码看起来非常清晰。如果有的行用空格做缩进，有的行用Tab做缩进，甚至空格和Tab混用，那么一旦改变了文本编辑器的Tab显示宽度就会看起来非常混乱，所以内核代码风格规定只能用Tab做缩进，不能用空格代替Tab。

  1. 语句块的{或}应该和关键字写在同一行，用空格隔开，而不是单独占一行 if/else、while、do/while、for、switch这些可以带语句块的语句，语句块的{或}应该和关键字写在同一行，用空格隔开，而不是单独占一行。例如应该这样写：
1
2
3
4
5

if␣(...)␣{
       →语句列表
}␣else␣if␣(...)␣{
       →语句列表
}

但很多人习惯这样写：

1
2
3
4
5
6
7
8

if␣(...)
{
    →语句列表
}
else␣if␣(...)
{
    →语句列表
}

内核的写法和[K&R]一致，好处是不必占太多行，使得一屏能显示更多代码。这两种写法用得都很广泛，只要在同一个项目中能保持统一就可以了。

  1. 函数定义的{和}单独占一行，这一点和语句块的规定不同
1
2
3
4

int␣foo(int␣a,␣int␣b)
{
    →语句列表
}
  1. switch和语句块里的case、default对齐写 switch和语句块里的case、default对齐写，也就是说语句块里的case、default标号相对于switch不往里缩进，但标号下的语句要往里缩进。例如：
1
2
3
4
5
6
7
8

→switch␣(c)␣{
→case 'A':
→       →语句列表
→case 'B':
→       →语句列表
→default:
→       →语句列表
→}

用于goto语句的自定义标号应该顶头写不缩进，而不管标号下的语句缩进到第几层。

  1. 代码中每个逻辑段落之间应该用一个空行分隔开 例如每个函数定义之间应该插入一个空行，头文件、全局变量定义和函数定义之间也应该插入空行，例如：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

#include <stdio.h>
#include <stdlib.h>

int g;
double h;

int foo(void)
{
    →语句列表
}

int bar(int a)
{
    →语句列表
}

int main(void)
{
    →语句列表
}
  1. 一个函数的语句列表如果很长，也可以根据相关性分成若干组，用空行分隔。 一个函数的语句列表如果很长，也可以根据相关性分成若干组，用空行分隔。这条规定不是严格要求，通常把变量定义组成一组，后面加空行，return语句之前加空行，例如：
1
2
3
4
5
6
7
8
9
10
11

int main(void)
{
    →int    →a, b;
    →double →c;

    →语句组1

    →语句组2

     →return 0;
}

Comments