作用:
为了避免同一个文件被include多次,C/C++中有两种方式,一种是#ifndef方式,一种是#pragma once方式。在能够支持这两种方式的编译器上,二者并没有太大的区别,但是两者仍然还是有一些细微的区别。
区别:
#pragme once
#pragma once
... ... // 声明、定义语句
- #pragma once是 编译器相关 的,有的编译器支持,有的编译器不支持,具体情况请查看编译器API文档,不过大部分编译器都有这个预处理指令了。
- #pragma once一般由编译器提供保证:同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。你无法对一个头文件中的一段代码作pragma once声明,而只能针对文件。
- 其好处是,你不必再费劲想个宏名了,当然也就不会出现宏名碰撞引发的奇怪问题。大型项目的编译速度也因此提高了一些。
- 对应的缺点就是如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。当然,相比宏名碰撞引发的“找不到声明”的问题,这种重复包含很容易被发现并修正。
#ifndef
#ifndef __SOMEFILE_H__
#define __SOMEFILE_H__
... ... // 声明、定义语句
#endif
- #ifndef,#define,#endif是C/C++语言中的宏定义,#ifndef的方式依赖于 宏名字不能冲突(__SSOMEFILE_H__),避免文件多次编译。所以在 所有支持C++语言的编译器上都是有效的,如果写的程序要 跨平台,最好使用这种方式。
- #ifndef的方式受C/C++语言标准支持。它不光可以保证 同一个文件不会被包含多次,也能保证 内容完全相同的两个文件(或者代码片段) 不会被不小心同时包含。
- 当然,缺点就是如果不同头文件中的宏名不小心“撞车”,可能就会导致你看到头文件明明存在,编译器却硬说找不到声明的状况——这种情况有时非常让人抓狂。
- 由于编译器每次都 需要打开头文件 才能判定是否有重复定义,因此在编译大型项目时,ifndef会使得 编译时间相对较长,因此一些编译器逐渐开始支持#pragma once的方式。
注:
- #pragma once方式产生于#ifndef之后,因此很多人可能甚至没有听说过。目前看来 #ifndef更受到推崇。因为#ifndef受C/C++语言标准的支持,不受编译器的任何限制;而#pragma once方式却不受一些较老版本的编译器支持,一些支持了的编译器又打算去掉它,所以它的兼容性可能不够好。一般而言,当程序员听到这样的话,都会选择#ifndef方式,为了努力使得自己的代码“存活”时间更久,通常宁愿降低一些编译性能。