文件包含与头文件的写法

很多人对C语言中的 “文件包含”都不陌生了，文件包含处理在程序开发中会给我们的模块化程序设计带来很大的好处，通过文件包含的方法把程序中的各个功能模块联系起来是模块化程序设计中的一种非常有利的手段。文件包含处理是指在一个源文件中，通过文件包含命令将另一个源文件的内容全部包含在此文件中。在源文件编译时，连同被包含进来的文件一同编译，生成目标文件。很多人再初学时都会对这个很晕，怎么写文件? 怎么包含才能避免重定义? 等等问题。。。其实这个只要了解了文件包含的基本处理方法就可以对文件包含有一个很好的理解与应用了，下来我们一起来看一下：

文件包含的处理方法：

首先大家需要清楚：
(1)处理时间：文件包含也是以"#"开头来写的(#include), 那么它就是写给预处理器来看了, 也就是说文件包含是会在编译预处理阶段进行处理的。
(2)处理方法：在预处理阶段，系统自动对#include命令进行处理，具体做法是将包含文件的内容复制到包含语句(#include )处，得到新文件，然后再对这个新文件进行编译。

抓住这两点，那么这个东东就没有什么难的了。。。一般情况下文件包含分为两种：包含.h文件和包含.c文件

1. 当然对于这两情况也都是按照上面说的方法来处理的。呵呵，这个肯定是没得说的.
2. 包含.c文件和编译多文件程序是不同的。
   多文件程序: 是在源文件编译时把多个文件先进行编译、再连接在一起生成一个可执行文件。
   包含.c文件:按照我们上边的说法则是把多个文件合并为一个文件进行编译。

接下来通过例子看一下：
(1)包含.c文件:

//file1:  main.c
#include
#include "fun.c"
int main()
{
    int a=5,b=19;
    c = a;   
    sun(a,b);
    printf("c=%d\n",c);
    return 0;
}
//end of file1
 
//file2: fun.c
int c=0;
void sun(int a, int b)
{
    printf("a+b=%d\n",a+b);
    c=0;
    printf("c=%d\n",c);
}
//end of file2  

这个例子是采用 包含 .c 文件 的方法实现的。 在编译时，直接去编译 main.c 文件，预处理器会先把 fun.c 文件中的内容复制到 main.c 中来，然后再对新的 main.c 进行编译。

编译命令：gcc main.c -o main   可以看到，这里并没有对fun.c进行编译，但还是生成了最终的main可执行程序。

也可以通过命令来观察一下预处理的结果：

编译命令：gcc -E main.c -o main.cpp
在main.cpp文件末尾可以看来下面一段代码：

//main.cpp文件中
931 # 2 "main.c" 2
932 # 1 "fun.c" 1
933 //注意这里是fun.c里边的内容
934 int c=0;
935 void sun(int a, int b)
936 {
937  printf("a+b=%d\n",a+b);
938  c=0;
939  printf("c=%d\n",c);
940 }
    //这里是main函数
941 # 3 "main.c" 2
942 int main()
943 {
944  int a=5,b=19;
945  c = a;
946  printf("c=%d\n",c);
947  sun(a,b);
948  printf("c=%d\n",c);
949  return 0;
950 }

可见，其实就是将fun.c文件中的内容添加到了main函数之前，然后对新的文件进行编译，生成最终的可执行程序。

 (2)编译多文件程序：

同样是上边的例子，把main.c中“ #include "fun.c" ”注释掉，加上一句：“extern int c;”因为 c 变量在另外一个文件(fun.c)中定义。

//file1:  main.c
#include
//#include"fun.c"  //注释掉
extern int c;        //添加这一句
int main()
{
    int a=5,b=19;
    c = a;   
    sun(a,b);
    printf("c = %d\n",c);
    return 0;
}
//end of file1

//file2: fun.c
int c = 0;
void sun(int a, int b)
{
    printf("a+b=%d\n",a+b);
    c=0;
    printf("c=%d\n",c);
}
//end of file2 

这次如果还是按照上面的方法只编译 main.c 的话就会出错，因为变量 c 和函数 sun 并没有在 main.c 中定义，所以编译时需要将 fun.c 一起编译：

编译命令：   

    gcc -c main.c -o main.o       #编译main.c
    gcc -c fun.c -o fun.o              #编译fun.c
    gcc main.o fun.o -o main    #用main.o fun.o生成main

       到这里大家应该已经理解包含.c文件和多文件程序的本质区别了～～～

好了，大家不防想想这两种方法的优缺点，这里就只写不足之处了：
1. 包含.c文件的方法: 容易产生"重定义",大家想想如果一个工程中有多个文件都同时包含了某一个件，那么这个被包含文件的内容就会被复制到多个文件中去，也就相当于每个包含该文件的文件中都定义被包含文件中的变量和函数，这样在链接时就会产生"重定义"错误。

2. 多文件分开编译的方法: 这个比较好，不容易出现"重定义"之类的问题，这也是我们最常用的一种方法，但是并不是像上面这个例子中这样直接去用，而是使用"头文件"将各个.c文件联系起来。
     上边这个例子大家会发现，在main.c中需要加上“extern int c;”这样一句声明，如果包含的文件较多？如果全局变量较多？...这个我们可以省掉吗？回答是肯定的！方法就是给它写上一个头文件。

接下来看一下使用头文件的来实现这个例子的方法：

//file1:  main.c
#include
#include "fun.h"      //fun.c修改为fun.h
//extern int c;       //这行也不要了
int main()
{
    int a=5,b=19;
    c = a;   
    sun(a, b);
    printf("c=%d\n",c);
    return 0;
}
//end of file1
 
//file2: fun.c
#include "fun.h"
int c=0;                     //变量c的定义
void sun(int a, int b)        //函数sun()的定义
{
    printf("a+b=%d\n",a+b);
    c=0;
    printf("c=%d\n",c);
}
//end of file2 
 
//file3: fun.h
externint c;             //把c声明为外部可用的
void sun(int a, int b);   //sun()函数的声明
//end of file3

这样再看一下，在要用到fun.c中定义的函数或变量的文件中只要包含fun.h文件就可以了，是不是这样？？？呵呵，当然是了。。。

预处理时会把fun.h中的内容复制到包含它的文件中去，而复制的这些内容只是声名，不是定义，所以它被复制再多份也不会出现"重定义"的错误。。。

呵呵，对，就是这样，这就是头文件给我们再来的好处。

前面说了头文件的方法也是模块化程序设计中的一种非常有利的手段。把同一类功能写到一个.c文件中，这样可以把他们划为一个模块，另外再对应的写上一个.h文件做它的声明。这样以后再使用这个模块时只需要把这两个文件添加进工程，同时在要使用模块内函数或变量的文件中包含.h文件就可以了。

    举个很实际的例子，在单片机、ARM或其他嵌入式开发中，每一个平台可能本身都有多种不同的硬件模块，使用时需要去写相应的驱动程序，这样就可以把各个硬件模块的驱动程序作为一个模块(比如lcd驱动对对应lcd.c和lcd.h，IIC驱动对应I2C.c和I2C.h等)，当具体使用到某个模块时，只需要在将对应的.c和.h文件添加进工程，并在文件中包含对就的.h文件即可。 

所以关于头文件的写法个人总结以下几点:
(1) 对应的.c文件中写变量、函数的定义
(2) 对应的.h文件中写变量、函数的声明
(3) 如果有数据类型的定义和宏定义，请写的头文件(.h)中
(4) 头文件中一定加上#ifndef...#define....#endif之类的防止重包含的语句
(5) 模块的.c文件中别忘包含自己的.h文件

呵呵，OK，就这些了，写的有点乱哦，希望对大家有帮助。。。

本文是转载来了，有些改动，原文作者对不起我找不到原文网址了。