【C++/C】防止头文件的重复包含的解决办法及对头文件的理解

###Date: 2018.5.5

============================================================================


    头文件一般只包含函数或变量的声明,不要包含定义,否则会出现重定义的问题;一般将函数实现或变量的定义放在C或cpp中;另外在c或cpp中头文件的重复包含也会出现重定义的问题。


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

[cpp] view plain copy
  1.   方式一:  
  2.   #ifndef __SOMEFILE_H__  
  3. //或写为#if !define __SOMEFILE_H__   
  4.   #define __SOMEFILE_H__  
  5.   ... ... // 声明、定义语句  
  6.   #endif  
  7.   方式二:  
  8.   #pragma once  
  9.   ... ... // 声明、定义语句  

一) #ifndef的方式受C/C++语言标准支持

优点

(1) 不光可以保证同一个文件不被包含多次,也能保证内容完全相同的两个文件(或者代码片段)不被同时包含。

(2)受C/C++语言标准的支持,不受编译器的任何限制

缺点:

(1)如果不同头文件中的宏名不小心“撞车”,可能就会导致你看到头文件明明存在,编译器却硬说找不到声明的状况——这种情况有时非常让人抓狂。

(2)由于编译器每次都需要打开头文件才能判定是否有重复定义,因此在编译大型项目时,ifndef会使得编译时间相对较长,因此一些编译器逐渐开始支持#pragma 
once的方式。

 (二)#pragma once一般由编译器提供保证。

同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件,而不是指内容相同的两个文件。你无法对一个头文件中的一段代码作pragma once声明,而只能针对文件。

  优点:

(1)你不必再费劲想个宏名了,当然也就不会出现宏名碰撞引发的奇怪问题

(2)大型项目的编译速度也因此提高了一些。

  缺点:

  (1)就是如果某个头文件有多份拷贝,本方法不能保证他们不被重复包含。当然,相比宏名碰撞引发的“找不到声明”的问题,这种重复包含很容易被发现并修正。

  (2)而#pragma once方式却不受一些较老版本的编译器支持,一些支持了的编译器又打算去掉它,所以它的兼容性可能不够好

 

   (三)还看到一种用法是把两者放在一起的:

[cpp] view plain copy
  1.   #pragma once  
  2.   #ifndef __SOMEFILE_H__  
  3.   #define __SOMEFILE_H__  
  4.   ... ... // 声明、定义语句  
  5.   #endif  

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

 

                选择哪种方式,应该在了解两种方式的情况下,视具体情况而定。只要有一个合理的约定来避开缺点,我认为哪种方式都是可以接受的。



参考:https://blog.csdn.net/xhfight/article/details/51550446

https://blog.csdn.net/zhanh1218/article/details/35637273

原文地址:https://www.cnblogs.com/SoaringLee/p/10532504.html