C++中避免头文件冲突之#ifndef篇

在头文件中使用#ifdef和＃ifndef是非常重要的，可以防止双重定义的错误。

如你在头文件aaa.h中定义了一个类aaa如下：   
class   aaa   
{   
};   
如果两次＃include   "aaa.h"（不见得是直接，也有可能两个不同的头文件中都包含了这个头文件）就会出错，因为相同的类不能定义两次。把aaa.h稍做修改：   
#ifndef   _aaa_   
#define   _aaa_   
class   aaa   
{   
};   
#endif   
就可以避免这样的问题。因为当你已经包含过这个文件，_aaa_就会有了定义，那么#ifndef的条件为假，就不会再执行后面的类定义了。

 

#ifdef和#endif必须成对使用。   
从理论上讲可以出现在任何地方（头文件和实现文件中）   
通常为了防止头文件被多次包含，在头文件中使用是必须的：   
如：#ifndef   MY_HEAD_H   //头文件开头,名字是任意的,注意不要和其它头文件冲突  

(一)头文件声明   
      #ifndef

      #define
      #endif     //头文件结尾

有时候，在b.h中会include   "a.h"   
在"c.h"中会include   "b.h"及include"a.h"，   
这时，如果不用ifndef/endif，就会包含两次a.h,产生错误。此时正确的做法就是:

"a.h"

---------------------------------------------------------------------------------------------------------------

#ifndef _A_H_

#define _A_H_

.....//content of the head file

#endif

"b.h"

----------------------------------------------------------------------------------------------------------------

#include "a.h"

........//content of "b.h"

"c.h"

----------------------------------------------------------------------------------------------------------------

#include "a.h"

........//content of "c.h"

这样做应该就能解决问题了，但是，我不建议这么做，因为就算这样条件预编译了，整个图文集内容会被忽略，但预处理器还是会把整个文件读入的。由于这种预处理将托慢编译速度，所以如果可能，应该避免出现多重包含(也就是在<#pragma once与 #ifndef的区别>这篇博文里写的[1])。另外一种方法就是[1]里的#pragma once

条件编译，满足条件就编译，否则就不编译，如果有一段代码有时候你想要，有时候又不想编译（比如为了调试），可以这样写：   
#if   1(0)   
          xxxxxx   
          xxxxxx   
#endif   
需要的时候写1，不要的时候改为0就可以了

文件中的#ifndef 
头件的中的#ifndef，这是一个很关键的东西。比如你有两个C文件，这两个C文件都include了同一个头文件。而编译时，这两个C文件要一同编译成一个可运行文件，于是问题来了，大量的声明冲突。

还是把头文件的内容都放在#ifndef和#endif中吧。不管你的头文件会不会被多个文件引用，你都要加上这个。一般格式是这样的：

#ifndef <标识> 
#define <标识>

...... 
......

#endif

<标识>在理论上来说可以是自由命名的，但每个头文件的这个“标识”都应该是唯一的。标识的命名规则一般是头文件名全大写，前后加下划线，并把文件名中的“.”也变成下划线，如：stdio.h

#ifndef _STDIO_H_ 
#define _STDIO_H_

......

#endif

2.在#ifndef中定义变量出现的问题（一般不定义在#ifndef中）。

#ifndef AAA
#define AAA
...
   int i;
   ...
#endif
里面有一个变量定义
在vc中链接时就出现了i重复定义的错误，而在c中成功编译。

结论：

(1).当你第一个使用这个头的.cpp文件生成.obj的时候，int i 在里面定义了当另外一个使用这个的.cpp再次[单独]生成.obj的时候，int i 又被定义然后两个obj被另外一个.cpp也include 这个头的，连接在一起，就会出现重复定义.

(2).把源程序文件扩展名改成.c后，VC按照C语言的语法对源程序进行编译，而不是C++。在C语言中，若是遇到多个int i，则自动认为其中一个是定义，其他的是声明。

(3).C语言和C++语言连接结果不同，可能（猜测）时在进行编译的时候，C++语言将全局
变量默认为强符号，所以连接出错。C语言则依照是否初始化进行强弱的判断的。（参考）

解决方法：

(1).把源程序文件扩展名改成.c。

(2).推荐解决方案：
.h中只声明 extern int i;在.cpp中定义

<x.h>
#ifndef __X_H__
#define __X_H__
extern int i;
#endif //__X_H__
<x.c>
int i;

[1].<#pragma once与 #ifndef的区别>: http://hi.baidu.com/christole/blog/item/78ff759558c33c05d21b70bb.html