【C++/C】防止頭文件的重復包含的解決辦法及對頭文件的理解

###Date: 2018.5.5

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

    頭文件一般只包含函數或變量的聲明，不要包含定義，否則會出現重定義的問題；一般將函數實現或變量的定義放在C或cpp中；另外在c或cpp中頭文件的重復包含也會出現重定義的問題。

     為了避免同一個文件被include多次，C/C++中有兩種方式，一種是#ifndef方式，一種是#pragma once方式。在能夠支持這兩種方式的編譯器上，二者並沒有太大的區別，但是兩者仍然還是有一些細微的區別。

   方式一：
   #ifndef __SOMEFILE_H__
 //或寫為#if !define __SOMEFILE_H__
   #define __SOMEFILE_H__
   ... ... // 聲明、定義語句
   #endif
   方式二：
   #pragma once
   ... ... // 聲明、定義語句

（一） #ifndef的方式受C/C++語言標准支持

優點：

（1） 不光可以保證同一個文件不被包含多次，也能保證內容完全相同的兩個文件（或者代碼片段）不被同時包含。

（2）受C/C++語言標准的支持，不受編譯器的任何限制

缺點：

（1）如果不同頭文件中的宏名不小心“撞車”，可能就會導致你看到頭文件明明存在，編譯器卻硬說找不到聲明的狀況——這種情況有時非常讓人抓狂。

（2）由於編譯器每次都需要打開頭文件才能判定是否有重復定義，因此在編譯大型項目時，ifndef會使得編譯時間相對較長，因此一些編譯器逐漸開始支持#pragma 
once的方式。

 （二）#pragma once一般由編譯器提供保證。

同一個文件不會被包含多次。注意這里所說的“同一個文件”是指物理上的一個文件，而不是指內容相同的兩個文件。你無法對一個頭文件中的一段代碼作pragma once聲明，而只能針對文件。

  優點：

（1）你不必再費勁想個宏名了，當然也就不會出現宏名碰撞引發的奇怪問題。

（2）大型項目的編譯速度也因此提高了一些。

  缺點：

  (1)就是如果某個頭文件有多份拷貝，本方法不能保證他們不被重復包含。當然，相比宏名碰撞引發的“找不到聲明”的問題，這種重復包含很容易被發現並修正。

  (2)而#pragma once方式卻不受一些較老版本的編譯器支持，一些支持了的編譯器又打算去掉它，所以它的兼容性可能不夠好。

 

   (三)還看到一種用法是把兩者放在一起的：

   #pragma once
   #ifndef __SOMEFILE_H__
   #define __SOMEFILE_H__
   ... ... // 聲明、定義語句
   #endif

    看起來似乎是想兼有兩者的優點。不過只要使用了#ifndef就會有宏名沖突的危險，也無法避免不支持#pragma once的編譯器報錯，所以混用兩種方法似乎不能帶來更多的好處，倒是會讓一些不熟悉的人感到困惑。

 

                選擇哪種方式，應該在了解兩種方式的情況下，視具體情況而定。只要有一個合理的約定來避開缺點，我認為哪種方式都是可以接受的。

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

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