防止頭文件重複包含之pragma once與#ifndef

在我們自己編寫 C/C++的頭文件時,可能會忽略一點:用一些處理機制來避免頭文件的重複包含,因爲頭文件的內容在預編譯時是把頭文件的內容完全拷貝到引入的地方替換頭文件的包含命令,而包含的頭文件可能有包含很多內容,所以要是重複包含頭文件,可能會使預編譯後的源文件代碼冗餘量很大,造成空間上的浪費。
目前自己用過兩個防止頭文件重複包含的方法:
1、 #pragma once
2、 #ifndef
  #define
  #endif
  
它們具體實現如下:
假定此時要保證頭文件HeadFile.h不會被重複包含,那麼兩種方法對應的方式如下:
1、 #pragma once
  直接把它放在HeadFile.h文件實現的最前面,即可實現。
  

  #pragma once
  //頭文件的具體實現

2、 #ifndef
  #define
  #endif

  #ifndef __HEADFILE.H__
  #define __HEADFILE.H__
  //頭文件的具體實現
  #endif

兩種方法的一些差異:
1、 #pragma once由編譯器提供保證:同一個文件不會被編譯多次。注意這裏所說的“同一個文件”是指物理上的一個文件,而不是指內容相同的兩個文件。帶來的好處是,你不必再費勁想個宏名了,當然也就不會出現宏名碰撞引發的奇怪問題。對應的缺點就是如果某個頭文件有多份拷貝,本方法不能保證他們不被重複包含。當然,相比宏名碰撞引發的“找不到聲明”的問題,重複包含更容易被發現並修正。
2、 #ifndef的方式依賴於宏名字不能衝突,這不光可以保證同一個文件不會被包含多次,也能保證內容完全相同的兩個文件不會被不小心同時包含。當然,缺點就是如果不同頭文件的宏名不小心“撞車”,可能就會導致頭文件明明存在,編譯器卻硬說找不到聲明的狀況。

#pragma once是編譯器相關的,有的編譯器支持,有的編譯器不支持,具體情況請查看編譯器API文檔,不過現在大部分編譯器都有這個雜注了。
#ifndef,#define,#endif是C/C++語言中的宏定義,通過宏定義避免文件多次編譯。所以在所有支持C++語言的編譯器上都是有效的,如果寫的程序要跨平臺,最好使用這種方式。

方式一可以避免名字衝突,方式二由語言支持所以移植性好
#pragma once方式產生於#ifndef之後,因此很多人可能甚至沒有聽說過。目前看來#ifndef更受到推崇。因爲#ifndef受語言天生的支持,不受編譯器的任何限制;而#pragma once方式卻不受一些較老版本的編譯器支持,換言之,它的兼容性不夠好。也許,再過幾年等舊的編譯器死絕了,這就不是什麼問題了

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章