#ifndef/#define/#endif使用详解

转自：http://blog.csdn.net/abc5382334/article/details/18052757，感谢博主讲解。   

   想必很多人都看过“头文件中的 #ifndef/#define/#endif 防止该头文件被重复引用”。但是是否能理解“被重复引用”是什么意思？是不能在不同的两个文件中使用include来包含这个头文件吗？如果头文件被重复引用了，会产生什么后果？是不是所有的头文件中都要加入#ifndef/#define/#endif 这些代码？

    其实“被重复引用”是指一个头文件在同一个cpp文件中被include了多次，这种错误常常是由于include嵌套造成的。比如：存在a.h文件#include "c.h"而此时b.cpp文件导入了#include "a.h" 和#include "c.h"此时就会造成c.h重复引用。

头文件被重复引用引起的后果：

有些头文件重复引用只是增加了编译工作的工作量，不会引起太大的问题，仅仅是编译效率低一些，但是对于大工程而言编译效率低下那将是一件多么痛苦的事情。
有些头文件重复包含，会引起错误，比如在头文件中定义了全局变量(虽然这种方式不被推荐，但确实是C规范允许的)这种会引起重复定义。

    是不是所有的头文件中都要加入#ifndef/#define/#endif 这些代码？

    答案：不是一定要加，但是不管怎样，用ifnde xxx #define xxx#endif或者其他方式避免头文件重复包含，只有好处没有坏处。个人觉得培养一个好的编程习惯是学习编程的一个重要分支。

    下面给一个#ifndef/#define/#endif的格式：

    #ifndef A_H意思是"if not define a.h"  如果不存在a.h

    接着的语句应该#define A_H  就引入a.h

    最后一句应该写#endif   否则不需要引入

--------------------------------------------------------------------------------------------------
#ifndef GRAPHICS_H // 防止graphics.h被重复引用 
#define GRAPHICS_H 


#include <math.h> // 引用标准库的头文件 
… 
#include “header.h” // 引用非标准库的头文件 
… 
void Function1(…); // 全局函数声明 
… 
class Box // 类结构声明 
{ 
… 
}; 
#endif
--------------------------------------------------------------------------------------------------

以下摘自百度百科：

http://baike.baidu.com/link?url=mnzelphPFzCjK2ri2V_0XVANbg2gb3O3_AMcpOdZtnpZko7UlOTBJRC43sPnH-0YlELr9h11yKntMMYTO-Ul1q

这是 //if not defined的简写，是宏定义的一种，它是可以根据是否已经定义了一个变量来进行分支选择，一般用于调试等等。实际上确切的说这应该是预处理功能中三种（宏定义，文件包含和条件编译）中的一种----条件编译。

1定义

#define x //定义一个宏

...

#endif

//C语言在对程序进行编译时，会先根据 预处理命令进行“预处理”。C语言 编译系统包括预处理，编译和链接等部分。

#ifndef x //先测试x是否被宏定义过

#define x

程序段1 //如果x没有被宏定义过，定义x，并 编译程序段 1

#else

程序段2 //如果x已经定义过了则编译程序段2的语句，“忽视”程序段 1。

#endif//终止if

2作用编辑

条件指示符#ifndef 的最主要目的是防止 头文件的重复包含和编译。了解： 条件编译当然也可以用条件语句来实现。 但是用条件语句将会对整个 源程序进行编译，生成的 目标代码程序很长，而采用 条件编译，则根据条件只编译其中的 程序段1或程序段2，生成的 目标程序较短。如果条件选择的 程序段很长，采用 条件编译的方法是十分必要的。

3内容编辑

#ifndef 标识1 //判断"标识1"是否定义，如果被定义则返回假，如果没有被定义则返回真。

/**********************************/

语句1 #ifndef 标识1

语句2 #define 标识1

语句3 #endif

语句4 ……

语句5 ……

该段代码意思是：如果标识1没有被定义，则重定义标识1，即执行语句2、语句3;如果标识1已经被定义，则直接跳过语句2、语句3，直接执行语句4、语句5、……

/***********************************/

备注：#ifndef 和 #endif 要一起使用，如果丢失#endif，可能会报错。

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

例如要编写头文件test.h

在头文件开头写上两行：

#ifndef _TEST_H

#define _TEST_H//一般是文件名的大写 头文件结尾写上一行：

#endif

这样一个工程文件里同时包含两个test.h时，就不会出现重定义的错误了。

分析:

当第一次包含test.h时，由于没有定义_TEST_H，条件为真，这样就会包含（执行）#ifndef _TEST_H和

#endif之间的代码，当第二次包含test.h时前面一次已经定义了_TEST_H，条件为假，#ifndef _TEST_H和

#endif之间的代码也就不会再次被包含，这样就避免了重定义了.

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

#ifndef <标识>

#define <标识>

......

......

#endif

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

#ifndef _STDIO_H

#define _STDIO_H

......

#endif

4作用编辑

在c语言中，对同一个 变量或者函数进行多次声明是不会报错的。所以如果h文件里只是进行了声明工作，即使不使用# ifndef 宏定义，一个c文件多次包含同一个h文件也不会报错。　使用#ifndef可以避免下面这种错误：如果在h文件中定义了 全局变量，一个c文件包含同一个h文件多次，如果不加#ifndef 宏定义，会出现变量重复定义的错误；如果加了#ifndef，则不会出现这种错.

5形式编辑

“ 条件编译”命令允许对程序中的内容选择性地编译，即可以根据一定的条件选择是否编译。

条件编译的命令主要有以下几种 ：

形式1

#ifndef  标识符

程序段 1

#else

程序段 2

#endif

它的作用是当 “  标识符”没有由# define定义过了。则编译“  程序段 1 ” 。 否则编译“  程序段 2 ” 。其中如果不需要编译“ 程序段 2 ”。则上述形式可以变换 为：

#ifndef  标识符

程序段 1

#endif

形式2

#ifndef 标识符

# define  标识符

程序段 1

#else

程序段 2

#endif

它的作用是当 “  标识符 没有由# define定义过。 则编译“ 程序段 1”。否则编译“ 程序段 2” 。同样当无“  程序段2 ”时。(作用与 形式1完全相同)则上述形式变换为：

# ifndef 标识符

# define  标识符

程序段 1

#endif

形式3

#if  表达式

程序段 1

#else

程序段 2

#endif

它的作用是 当“ 表达式”值为真时。编译程序段1。否则则编译程序段2。同样 当无 程序段 2时，则上述形式变换为 ：

#if 表达式

程序段 1

#endif

以上三种形式的条件编译预处理结构都可以嵌套使用。 当#else后嵌套 #if 时，可以使用 预处理命令 # elif ， 它相当于 #else#if。在程序中使用 条件编译主要是为了方便程序的调试和移植。