一篇还不错的介绍头文件的小文章

时间:2021-06-05 18:09:48
 扩展名为.h的文件,在C语言中被称为header file, 也就是头文件。
头文件的数据格式就是普通的文本文件,可以通过新建文本文件(txt),再把扩展名改为.h的方式创建,在此不赘述。


一、头文件内容格式。
头文件内容并没有固定的格式要求,不过一般为防止嵌套引用给编译器带来死锁或者没必要的开销,一般约定整个头文件中所有内容在一个条件编译下,即如下格式:
#ifndef 宏名
#define 宏名
//头文件主体
#endif
这样可以保证一个头文件在一个源文件中最多只被引用一次。为避免宏名重复,宏名一般由头文件名转换而来,如果头文件名是xxx.h,那么宏名一般定义为:
_XXX_H_
即前后各加一个下划线,同时文件名中除数字、字母、下划线以外的字符均转换为下划线(_)。


头文件主体中内容同样没有做强制约定,可以出现在源文件(.c)中的任何代码均可以放在头文件中。不过一般情况下可以包括以下几种内容:
1 引用其它头文件,格式为
#include <xxx.h>

#include "xxx.h"
二者区别在介绍头文件引用时再详细介绍。
2 定义私有类型。比如
typedef unsigned long U32; //为了简写而给无符号32位整型定义一个新的名字
struct xxx {};
也可以是enum, union等复杂类型。
3 宏定义。比如
#define MAX(a,b) (a>b?a:b)
4 函数声明。比如
void test_function(void);
5 全局变量声明。比如
extern int global_var;
6 如果有一个静态全局变量需要在不同源文件中使用,但各文件之间互不相关。那么可以放在头文件中。如:
static int gs_var = 3;


7 对于支持C99规范的C编译器,还可以把内联函数定义在头文件中。比如
static inline int get_min(int a, int b)
{
    if(a>b) return b;
    return a;
}
以上是常见的头文件中的元素。但实际上头文件中也可以放全局变量的定义,全局函数的实现等。但是头文件中一旦定义了这样的元素,这个头文件在一个工程中只能被一个文件引用,否则编译器会报重复定义的错误。
比如如果有一个规模很大的常量数组,比如一副图片的二进制值,如果把它定义在源文件中,就会显得很冗余,因为并不会经常修改。 这时可以定义在头文件中,只在一个源文件中引用,当有多幅图片需要随时更换时,也可以通过简单的在源文件中修改引用的头文件名达到修改的目的。


二、头文件的引用。
头文件引用的方法其实之前已经大致说过了,在源文件中引用头文件和在头文件中引用的格式是一样的:
#include<xxx.h>或者
#include "xxx.h"
xxx为头文件名。
用<>和""是有一定的区别的。在编译器查找头文件的时候,会在两个区域分别查找。
一个是系统头文件区域,即类似于stdio.h一类的C库函数头文件区。
另一个是自定义头文件区,比如当前目录,以及其它自定义的目录。
用<>时,编译器会先在系统区域查找,然后再查找自定义区域。而用""时则相反。
由于一般并不推荐自定义头文件名与系统头文件名相同(容易引起歧义并难以维护),所以先后顺序并不是太重要,尤其在硬件速度越来越快的今天,使用哪种符号引用头文件已经差别很小了。