关于头文件重复包含问题

重复包含的影响：在预处理对时候，include相同的文件，预处理器会检查XXX是否有定义再决定要不要复制内容，重复包含会是编译器多检查几次而已。另外在使用增量编译的时候，这个文件变化，所有

include

这个文件的文件都需要重新编译，即使没有去使用里面的任何内容。

避免方法：

1.把头文件放在宏里：

#ifndef

标志（这个标志本来可以随便自己定义，但是为了防止混乱，所以一般都会采用自己的文件名字：__WENJIAN_H__）

#define

标志

//文件内容

#endif

在头文件定义前面添加

#pragma

once

（不太通用）

就可以防止一个头文件被多次包含，进而防止重复定义的错误。

在用VC6.0向导生成的头文件中，经常可以看见如下的代码段:

#if

!defined(AFX_RESIZABLELAYOUT_H__INCLUDED_)

#define

AFX_RESIZABLELAYOUT_H__INCLUDED_

#if

_MSC_VER

>

1000

#pragma

once

#endif

//

_MSC_VER

>

1000

...

#endif

//

!defined(AFX_RESIZABLELAYOUT_H__INCLUDED_)

对于宏有基本了解的朋友应该都知道，头文件中如下的宏定义，是为了避免同样的头文件在同一个.C文件或者.CPP文件多次包含。

#if

!defined(XXX)

#define

XXX

#endif

这很好理解，但接下来的一段，尤其是#pragma

once的意思，我就不是很清楚了。从MSDN得到pragma

once的解释是:

"Specifies

that

the

file

will

be

included

(opened)

only

once

by

thecompiler

when

compiling

a

source

code

file."

英文注释的大意也是说#pragma

once是为了避免文件重复包含。疑惑就此产生了，既然宏"#if

!defined"已经有这个作用了，为何还要一个"#pragma

once"呢?

我接着在网上搜到了几份答案，但大家的回答都很模糊，于是我想放弃，不再想这个问题，但还是不太甘心，就接着看了看别人的解释。突然间，好像灵犀一点，开

窍了。虽然"#if

!define"和"#pragma

once"都有避免重复包含的功能，但是在实现上还是有区别的。举一例如下：

//

Test1.h

#if

!define

(__TESTONE_H_)

#define

__TESTONE_H_

...

#endif

//

Test2.h

#pragma

once

...

//

Test.cpp

#include

"Test1.h"

//

line

1

#include

"Test1.h"

//

line

2

#include

"Test2.h"

//

line

3

#include

"Test2.h"

//

line

4

...

头文件Test1.h中用宏来避免重复，头文件Test2.h中用#pragma

once来避免重复。编译Test.cpp，将需要打开Test1.h两次，第一次发现宏__TESTONE_H_没有定义，接着就处理宏定义；第二次打

开Test1.h时，发现宏__TESTONE_H_已经定义过了，编译器就会略过宏定义部分，知道处理完Test1.h末尾的#endif。

而由于头文件Test2.h使用#pragma

once来避免重复定义的，在编译Test.cpp的过程中，Test2.h只会被打开一次，也就是处理到第3行的时候。因为Test2.h用的

是#pragma

once，所以在处理完第3行后，编译器已经知道包含了一次Test2.h，在它(编译器)处理第4行代码时，发现Test2.h已经包含过了，忽略掉第

4行代码，也就不需要再次打开Test2.h进行判断了。

总结一下，除了#pragma

once是微软编译器所特有的之外，用宏和#pragma

once的办法来避免重复包含头文件，主要区别在于宏处理的方法会多次打开同一头文件，而#pragma

once则不会重复打开，从而#pragma

once能够更快速。

#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按照被包含头文件的文件名进行取名，以避免由于其他头文件使用相同的符号而引起的冲突。

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

头文件被多次包含是：如有一个大型程序，为了提高可读性，程序员是分多个文件编写，不会写在一个文件中的，这样的话程序员把每个文件都包含到主程序所在的文件中，不能多次包含，否则会出现编译出错！！！

但是库文件的话可以多次包含，因为库文件中预编译命令。预编译命令是看条件编译，如果条件成立编译，否则不编译，也就是你编译一个文件时已经编译过这个头文件，再编译另一个文件时不会再编译那条头文件。

---