转：编写自己的C语言头文件

<一>. 一些初学C语言的人，不知道头文件（*.h文件）原来还可以自己写的。只知道调用系统库函数时，要使用#include语句将某些头文件包含进去。其实，头文件跟.C文件一样，是可以自己写的。头文件是一种文本文件，使用文本编辑器将代码编写好之后，以扩展名.h保存就行了。头文件中一般放一些重复使用的代码，例如函数声明，变量声明，常数定义，宏的定义等等。当使用#include语句将头文件引用时，相当于将头文件中所有内容，复制到#include处。为了避免因为重复引用而导致的编译错误，头文件常具有

#ifndefLABEL

#defineLABEL

//代码部分

#endif

的格式。其中，LABEL为一个唯一的标号，命名规则跟变量的命名规则一样。常根据它所在的头文件名来命名，例如，如果头文件的文件名叫做hardware.h，那么可以这样使用：

#ifndef__HARDWARE_H__

#define__HARDWARE_H__

#endif
的格式。其中，LABEL为一个唯一的标号，命名规则跟变量的命名规则一样。常根据它所在的头文件名来命名，例如，如果头文件的文件名叫做hardware.h，那么可以这样使用：

#ifndef__HARDWARE_H__

#define__HARDWARE_H__

//代码部分

#endif
这样写的意思就是，如果没有定义__HARDWARE_H__，则定义__HARDWARE_H__，并编译下面的代码部分，直到遇到#endif。这样，当重复引用时，由于__HARDWARE_H__已经被定义，则下面的代码部分就不会被编译了，这样就避免了重复定义。

<二>. 另外一个地方就是使用include时，使用引号与尖括号的意思是不一样的。使用引号(“”)时，首先搜索工程文件所在目录，然后再搜索编译器头文件所在目录。而使用尖括号(<>)时，刚好是相反的搜索顺序。假设我们有两个文件名一样的头文件hardware.h，但内容却是不一样的。一个保存在编译器指定的头文件目录下，我们把它叫做文件I；另一个则保存在当前工程的目录下，我们把它叫做文件II。如果我们使用的是#include<hardware.h>，则我们引用到的是文件I。如果我们使用的是#include“hardware.h”，则我们引用的将是文件II。笔者以前就遇到过一个同事问，为什么他修改了那个头文件里面的内容，好象跟没有修改一样？就是因为他有两个一样的头文件（就像我们刚描述的那样），他是使用#include<hardware.h>引用的，而他修改时，却是当前工程所在的目录下的那个文件。就是因为他有两个一样的头文件（就像我们刚描述的那样），他是使用#include<hardware.h>引用的，而他修改时，却是当前工程所在的目录下的那个文件。

<三>. 头文件定义和全局变量。

C程序采用模块化的编程思想，需合理地将一个很大的软件划分为一系列功能独立的部分合作完成系统的需求，在模块的划分上主要依据功能。模块由头文件和实现文件组成，对头文件和实现文件的正确使用方法是：

规则1 头文件(.h)中是对于该模块接口的声明，接口包括该模块提供给其它模块调用的外部函数及外部全局变量，对这些变量和函数都需在.h中文件中冠以extern关键字声明； 
规则2 模块内的函数和全局变量需在.c文件开头冠以static关键字声明； 
规则3 永远不要在.h文件中定义变量；

许多程序员对定义变量和声明变量混淆不清，定义变量和声明变量的区别在于定义会产生内存分配的操作，是汇编阶段的概念；而声明则只是告诉包含该声明的模块在连接阶段从其它模块寻找外部函数和变量。

规则4 如果要用其它模块定义的变量和函数，直接包含其头文件即可。

顺便说一句，extern可以用于所有类型的变量。在数组的声明中使用extern时，可以忽略数组的长度： extern int a[]; 因为此刻编译器不用为数组a分配空间，所以也就不需要知道数组a的长度了。

如果工程很大，头文件很多，而有几个头文件又是经常要用的，那么

1. 把这些头文件全部写到一个头文件里面去，比如写到preh.h

2. 写一个preh.c，里面只一句话：#include "preh.h" 

3. 对于preh.c，在project setting里面设置creat precompiled headers，对于其他 c文件，设置use precompiled header file