.h中的#ifndef..#define..#endif

  参考博文 《#pragma once与#ifndef #define …#endif的区别》

  #pragma once 用来防止某个头文件被多次 include;
  #ifndef#define#endif 用来防止某个宏被多次定义。

两种方式

  方式一:

1
2
3
4
// xxx.h
#pragma once

... ... // 一些声明语句

  方式二:

1
2
3
4
5
6
7
// xxx.h
#ifndef _XXX_H_
#define _XXX_H_

... ... // 一些声明语句

#endif

有什么问题?

  #pragma once 是编译相关,就是说这个编译系统上能用,但在其他编译系统不一定可以,也就是说移植性差,不过现在基本上已经是每个编译器都有这个定义了;

  #ifndef 的方式依赖于宏名字不能冲突,这不光可以保证同一个文件不会被包含多次,也能保证内容完全相同的两个文件不会被不小心同时包含。当然,缺点就是如果不同头文件的宏名不小心 “撞车”,可能就会导致头文件明明存在,编译器却硬说找不到声明的状况。

该如何抉择?

  #ifndef…#define…#endif 这个是 C++ 语言相关,这是 C++ 语言中的宏定义,通过宏定义避免文件多次编译。所以在所有支持 C++ 语言的编译器上都是有效的,如果写的程序要跨平台,最好使用这种方式。

  #pragma once 则由编译器提供保证:同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。带来的好处是,你不必再费劲想个宏名了,当然也就不会出现宏名碰撞引发的奇怪问题。对应的缺点就是如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。当然,相比宏名碰撞引发的 “找不到声明” 的问题,重复包含更容易被发现并修正。

  #pragma once 方式产生于 #ifndef 之后,因此很多人可能甚至没有听说过。目前看来 #ifndef 更受到推崇。因为 #ifndef 受语言天生的支持,不受编译器的任何限制;而#pragma once 方式却不受一些较老版本的编译器支持,换言之,它的兼容性不够好。也许,再过几年等旧的编译器死绝了,这就不是什么问题了。

另类的奇葩?

  此外,还有一种方式是 把上述两者放在一起 的:

1
2
3
4
5
6
// xxx.h
#pragma once
#ifndef _XXX_H_
#define _XXX_H_
... ... // 一些声明语句
#endif

  看起来似乎是想兼有两者的优点。不过 只要使用了 #ifndef 就会有宏名冲突的危险,所以混用两种方法似乎不能带来更多的好处,倒是会让一些不熟悉的人感到困惑

综上

  建议使用 #ifndef…#define…#endif 方式一,另外,定义的宏最好与文件名相关,如 xxx.h 其宏定义按照格式为: _XXX_H_,这可以一定程度上保证宏名字不冲突。

  

文章目录
  1. 1. 两种方式
  2. 2. 有什么问题?
  3. 3. 该如何抉择?
  4. 4. 另类的奇葩?
  5. 5. 综上