如何避免头文件被重复包含

#include文件的一个不利之处在于一个头文件可能会被多次包含，为了说明这种错误，考虑下面的代码:

#include "x.h"

#include "x.h"

显然，这里文件x.h被包含了两次，没有人会故意编写这样的代码。但是下面的代码:

#include "a.h"

#include "b.h"

看上去没什么问题。如果a.h和b.h都包含了一个头文件x.h。那么x.h在此也同样被包含了两次，只不过它的形式不是那么明显而已。

多重包含在绝大多数情况下出现在大型程序中，它往往需要使用很多头文件，因此要发现重复包含并不容易。要解决这个问题，我们可以使用条件编译。如果所有的头文件都像下面这样编写:

#ifndef _HEADERNAME_H

#define _HEADERNAME_H

...//(头文件内容)

#endif

那么多重包含的危险就被消除了。当头文件第一次被包含时，它被正常处理，符号_HEADERNAME_H被定义为1。如果头文件被再次包含，通过条件编译，它的内容被忽略。符号_HEADERNAME_H按照被包含头文件的文件名进行取名，以避免由于其他头文件使用相同的符号而引起的冲突。

但是，你必须记住预处理器仍将整个头文件读入，即使这个头文件所有内容将被忽略。由于这种处理将托慢编译速度，所以如果可能，应该避免出现多重包含。

#include 通常不会包含 .cpp 文件，如果包含的话，一般仅会包含如 static 的函数这样不会因为多次包含而导致链接问题的。

为了防止重复包含，头文件中都会有相应的处理，比如加上

#ifndef _STDIO_H_

#define _STDIO_H_

// 真正的头文件内容

#endif

这样在多次包含的时候，因为已经定义了 _STDIO_H_，所以第二次包含的内容会被忽略。

比较新的 C++ 编译器也支持 #pragma once，这样只要在头文件开头写上这一句，编译器就会在处理头文件的时候不包含多次了。

---