1. 简介

为了避免同一个文件被include多次,C/C++中有两种方式,一种是#ifndef方式,一种是#pragma once方式。在能够支持这两种方式的编译器上,二者并没有太大的区别,但是两者仍然还是有一些细微的区别。

2. 使用方式

1)#ifndef

  1. #ifndef __HEADFILE_H__
  2. #define __HEADFILE_H__
  3. //... // 一些声明语句
  4. #endif // __HEADFILE_H__

2)#pragma once

  1. #pragma once
  2. //... // 一些声明语句

3. 区别

1)#ifndef
#ifndef的方式依赖于宏名字不能冲突,这不光可以保证同一个文件不会被包含多次,也能保证内容完全相同的两个文件不会被不小心同时包含。当然,缺点就是如果不同头文件的宏名不小心“撞车”,可能就会导致头文件明明存在,编译器却硬说找不到声明的状况。
2)#pragma once
#pragma once则由编译器提供保证:同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。带来的好处是,你不必再费劲想个宏名了,当然也就不会出现宏名碰撞引发的奇怪问题。对应的缺点就是如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。

4. 附加说明

1) #pragma once方式产生于#ifndef之后,#ifndef受语言天生的支持,不受编译器的任何限制;而#pragma once方式却不受一些较老版本的编译器支持,换言之,它的兼容性不够好。
2)两者一起使用的情况

  1. #pragma once
  2. #ifndef __HEADFILE_H__
  3. #define __HEADFILE_H__
  4. ... ... // 一些声明语句
  5. #endif

看起来似乎是想兼有两者的优点。不过只要使用了#ifndef就会有宏名冲突的危险,所以混用两种方法似乎不能带来更多的好处,倒是会让一些不熟悉的人感到困惑。
选择哪种方式,应该在了解两种方式的情况下,视具体情况而定。事实上,只要有一个合理的约定来避开缺点,我认为哪种方式都是可以接受的。而这个已经不是标准或者编译器的责任了,应当由程序员来搞定。

参考

1)转载自#pragma once 与 #ifndef 解析