两种解决头文件被重复包含方法的联系与区别

在制作C/C++项目的过程中,应该会遇到关于头文件被重复包含的问题,几乎每一个C/C++程序员都应该知道如何来解决这一问题。通常来说,我们通常可以用两种方式来解决这一问题。

第一种 ---- 利用以下形式:

#ifndef  __XX_H__                                                                              #ifndef   XX_H

#define __XX_H__                        写成这样也可以-->                        #define  XX_H

<头文件定义正文>                                                                              <头文件定义正文>

#endif                                                                                                                                                               
#endif

__XX_H__  其实就是一个标志,(这个标志本来可以随便自己定义,但是为了防止混乱,所以一般都会采用自己的文件名字:__XX_H__),而且 ifndef 也可以写成 if !defined 效果是一样的。(注:ifndef  不要错写成  ifdef)

当然还有第二种 ---- 在windows平台下,有一个很方便的宏: #pragma once

这个宏我们用MSDN打开查看一下可以得到以下解释内容:

"Specifies that the file will be included (opened) only once by thecompiler when compiling a source code file."

从字面上看这句英文的主要意思就是防止头文件被重复包含。于是我们就想,既然这两种方法都可以起到防止头文件被多次包含的作用,那么这两种方式有什么不同呢,或者说有什么相同之处呢?

首先我们来说一说重复包含的影响:

C/C++在预处理的时候,include相同的文件,预处理器会检查XXX是否有定义再决定要不要复制内容,重复包含会是编译器多检查几次而已。另外在使用增量编译的时候,这个文件变化,所有 include 这个文件的文件都需要重新编译,即使没有去使用里面的任何内容,所以重复包含最经常带来的错误就是重定义。

在用VC6.0向导生成的头文件中,经常可以看见如下的代码段:

  #if !defined(AFX_RESIZABLELAYOUT_H__INCLUDED_)

  #define AFX_RESIZABLELAYOUT_H__INCLUDED_

  #if _MSC_VER > 1000

  #pragma once

  #endif // _MSC_VER > 1000

  ...

  #endif // !defined(AFX_RESIZABLELAYOUT_H__INCLUDED_)

  对于宏有基本了解的朋友应该都知道,头文件中如下的宏定义,是为了避免同样的头文件在同一个.C文件或者.CPP文件多次包含。

  #if !defined(XXX)

  #define XXX

  #endif

由此可知这两种方式都可以很好的起到避免重复包含的作用,但是这两种有什么区别呢?

疑惑就此产生了,既然宏"#if !defined"已经有这个作用了,为何还要一个"#pragma once"呢?

其实虽然"#ifndef"和"#pragma once"都有避免重复包含的功能,但是在实现上还是有区别的。举一例如下:

  // Test1.h

  #ifndef  __COMMENT_CONVERT_H__

  #define __COMMENT_CONVERT_H__

  ...

  #endif

  // Test2.h

  #pragma once

  ...

  // Test.cpp

  #include "Test1.h" //

  #include "Test1.h" //

  #include "Test2.h" //

  #include "Test2.h" //

  ...

  头文件Test1.h中用宏来避免重复,头文件Test2.h中用#pragma once来避免重复。编译Test.cpp,将需要打开Test1.h两次,第一次发现宏__COMMENT_CONVERT_H__没有定义,接着就处理宏定义;第二次打 开Test1.h时,发现宏__COMMENT_CONVERT_H__已经定义过了,编译器就会略过宏定义部分,直到处理完Test1.h末的#endif。

  而由于头文件Test2.h使用#pragma once来避免重复定义的,在编译Test.cpp的过程中,Test2.h只会被打开一次,也就是处理到第3行的时候。因为Test2.h用的 是#pragma once,所以在处理完第3行后,编译器已经知道包含了一次Test2.h,在它(编译器)处理第4行代码时,发现Test2.h已经包含过了,忽略掉第 4行代码,也就不需要再次打开Test2.h进行判断了。

  总结一下,除了#pragma once是微软编译器所特有的之外,用宏和#pragma once的办法来避免重复包含头文件,主要区别在于宏处理的方法会多次打开同一头文件,而#pragma once则不会重复打开,从而#pragma once能够更快速。

用更确切的语言总结一下就是:#pragma once指定当前文件在构建时只被包含(或打开)一次,这样就可以减少构建的时间,因为加入#pragma once后,编译器在打开或读取第一个#include 模块后,就不会再打开或读取随后出现的同#include 模块。

时间: 2024-10-04 05:42:42

两种解决头文件被重复包含方法的联系与区别的相关文章

头文件被重复包含,嵌套包含的两层含义

http://www.cnblogs.com/bluestorm/archive/2011/11/04/2298126.html 说明: 写代码的时候头文件命名知道要加 #ifndef xxxx #define xxxx #endif 但是我把实现都放在了 .h文件中,然后出错了...所以头文件包含,只知其一不知其二,恩,就是所谓的 //a.h #ifndef _A_H_ #define _A_H_ int max(int a, int b) { return a > b ? a:b; } #e

防止头文件的重复包含问题

在我们自己编写 C/C++的头文件时,可能会忽略一点:用一些处理机制来避免头文件的重复包含,因为头文件的内容在预编译时是把头文件的内容完全拷贝到引入的地方替换头文件的包含命令,而包含的头文件可能有包含很多内容,所以要是重复包含头文件,可能会使预编译后的源文件代码冗余量很大,造成空间上的浪费. 1. #pragma once 2. #ifndef #define #endif 它们具体实现如下: 假定此时要保证头文件HeadFile.h不会被重复包含,那么两种方法对应的方式如下: 1. #prag

qt c++对象头文件如何相互包含

今天在写qt时,遇到了两个类相互包含的问题,类A要用到类B,类B要用到类A. 类A:a.h #ifndef A_H #define A_H #include <b.h> class A { public: A(); }; #endif // A_H a.cpp #include "a.h" A::A() { B b; } 类B:b.h #ifndef B_H #define B_H #include <a.h> class B { public: B(); };

#ifndef #define #endif 防止头文件被重复引用

想必很多人都看过“头文件中的 #ifndef/#define/#endif 防止该头文件被重复引用”.但是是否能理解“被重复引用”是什么意思?是不能在不同的两个文件中使用include来包含这个头文件吗?如果头文件被重复引用了,会产生什么后果?是不是所有的头文件中都要加入#ifndef/#define/#endif 这些代码?   其实“被重复引用”是指一个头文件在同一个cpp文件中被include了多次,这种错误常常是由于include嵌套造成的.比如:存在a.h文件#include "c.h

Eclipse 安装 ADT 失败的两种解决办法 [Android Development Tooling]

原因 最近想在新装的 Win7 里搭建一下 Android 的开发环境,虽然现在有 Android Studio 了,不过还是习惯 Eclipse 一点.众所周知的原因,Eclipse 直接安装 ADT(Android Develepment Tooling) 插件是不行的,这里给出两种解决办法,我们的前提是要先安装 Google 的 翻[email protected]!墙工具 GoAgent . 一.使用 Proxy 由于直接访问是不行的,所以你可以使用 VPN 或者 GoAgent 做为

两种 js下载文件的方法(转)

function DownURL(strRemoteURL, strLocalURL){ try{ var xmlHTTP = new ActiveXObject("Microsoft.XMLHTTP"); xmlHTTP.open("Get", strRemoteURL, false); xmlHTTP.send(); var adodbStream = new ActiveXObject("ADODB.Stream"); adodbStrea

解决头文件中定义全局变量MSVC、GNU编译器出现重定义问题

有时候我们经常碰到这样的事情,想定义某个类的静态成员,在头文件中定义该成员或者全局变量,头文件又同时被多个文件引用到,链接的时候则会出现,重定义,但是又不想在cpp文件中定义,现有一种方法可以解决此问题,直接上代码 #if defined(_MSC_VER ) __declspec(selectany) #elif defined(__GNUC__) __attribute__((weak)) #else #error "unknown complier" #endif int a=1

ASP+中文显示之两种解决方法

作者刚开始写ASP+程序时候碰到的第一个比较大的问题就是中文显示问题,运行后发现ASP+从数据库中读 取出来的中文全部变成了?????,有点类似jsp中的这个频率出现最高的中文显示问题了,查了资料发现有 两种方法可以轻松解决中文问题. 方法一: 在翻阅了微软NGWS文档后发现在文档的常见问题部分有提到要添加一个config.web文件到 web目录下,试了一下,中文显示果然OK了. 方法如下: 建立一个文件config.web,内容如下,放在WEB目录下 <configuration> <

C++中#include包含头文件带 .h 和不带 .h 的区别

C++中#include包含头文件带 .h 和不带 .h 的区别? 如 #include <iostream> 和 #include <iostream.h> 包含的东西有哪些不同? 之前在写C++程序的时候只知道使用 #include <iostream> 的时候,使用函数前要用 using namespace std; 导入命名空间,而 #include <iostream.h> 则不用,这个得看C+ +标准化过程为C++开发者做了哪些有意义的工作. (