精确包含头文件

原文http://yunli.blog.51cto.com/831344/275313

将原文精简了一下：

一：只包含必需的头文件。当foo.c文件在被编译时，第一步要做的是预处理，预处理的最终结果可以看作是将stdio.h和time.h中的内容全部放到foo.c文件中，当然，如果stdio.h和time.h中又包含其它的头文件的话，它们也都全部会被放入到最终的foo.c文件中，图2示例了采用GCC的-E选项所获得的最终预处理完的文件final.c，从图中可以看出，本来是7行的文件变成了1419行，这意味着什么？意味着如果多包含头文件则编译所花费的时间将更长。

foo.c
#include <stdio.h>
#include <time.h>

void foo ()
{
    printf ("Just for an example!\n");
}

图1

yunli.blog.51cto.com ~
$ gcc -E foo.c >final.c

yunli.blog.51cto.com ~
$ vi final.c
   1414 # 3 "foo.c" 2
   1415
   1416 void foo ()
   1417 {
   1418     printf ("Just for a test!\n");
   1419 }
:set nu

图2

    二：尽可能不要在头文件中包含其它的头文件，取而代之的是尽量在.c源文件中包含它们。对于图3和图4两种实现方式，光从foo()函数的角度来说是一模一样的，只是对于stdio.h头文件的包含一个是放在foo.h中的，而另一个则是放在foo.c中的。大部分情形下设计一个模块的目的是需要供其它的模块使用，而其它的模块在需要使用foo()函数时通常需要包含foo.h头文件。采用图3的实现方式将造成包含foo.h头文件则会导致间接地包含stdio.h，进而出现前面所讲的编译速度下降这一问题。

foo.h
#include <stdio.h>

void foo ();
foo.c
#include “foo.h”

void foo ()
{
    printf ("Just for an example!\n");
}

图3

foo.h
void foo ();
foo.c
#include <stdio.h>
#include “foo.h”

void foo ()
{
    printf ("Just for an example!\n");
}

图3