功能:#pragma once 和 #ifdef 都可以避免同一个文件被 include 多次。
1 #pragma once方式
#pragma once 是编译器相关,移植型差,有些编译器支持,有些编译器不支持,比如:gcc,vs 编译器支持,bcc 编译器不支持。由编译器提供保证,同一个文件不会被包含多次。这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。不用像使用 #ifdef 一样想宏名了,当然也就可以避免宏的名字冲突问题。缺点:如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。
看看 VC 自带的 Stdarg.h 头文件中是怎么使用 #pragma once 的,微软的东西还是权威
#if _MSC_VER > 1000
#pragma once
#endif
#ifndef _INC_STDARG
#define _INC_STDARG
#include <vadefs.h>
#define va_start _crt_va_start
#define va_arg _crt_va_arg
#define va_end _crt_va_end
#endif /* _INC_STDARG */
现在只看第 1-3 行,其中 _MSC_VER 宏是由微软编译器指定的,表示编译器的版本号。可以看到,在宏 _MSC_VER 的值小于 1000(VC5.0)时,它对 #pragma once 是不支持的。
2 #ifndef 方式
#ifndef 是 C 语言相关的,通过宏定义避免文件多次编译。所以在所有支持C/C++ 语言的编译器上都是有效的。跨平台移植性好。它依赖于宏名避免被 include 多次,如果宏已经定义了,#ifndef 将不满足条件,在预处理时,直到 #endif 处的代码会被直接删除。 这不光可以保证同一个文件不会被包含多次,也能保证内容完全相同的两个文件不会被同时包含,只认识宏,不管是不是相同的代码或者这是哪个文件。为了保证不同头文件中的宏名不冲突,使用文件名定义宏,例如文件名为 abc.h,就定义宏为 _ABC_H_。
还看Stdarg.h头文件,这个头文件里面不仅使用了#pragma once方式而且使用了#ifndef方式来保证该头文件不被多次include.
3 总结
性能区别
- 使用 #ifndef,编译器每次看到 #include 这个文件都需要读入文件,解析代码,效率低
- 而使用 #pragma once 编译器根本不会重复打开文件, 大大提高效率。
编码风格上
- 使用 #pragma once 的代码简洁
- #ifndef 定义如下:#ifndef…#define…#endif
语意区别
- #pragma once 针对文件,它告诉编译器,本文件只编译一次。
- #ifndef…#define…#endif 是针对文件中的某一个标号而言的,防止三个指令间包含的内容的重复性处理,更灵活。
可移植性方面
- #pragma once 依赖于编译器,可移植性较差
- #ifndef…#define…#endif 是 C/C++ 标准中的一部分,支持 C/C++ 的编译器都能使用,可移植性更高。