防止頭文件被重複包含的兩種方式#pragma once 與 #ifdef 的區別

當一個項目比較大時,往往都是分文件,這時候有可能不小心把同一個頭文件 包含多次,或者頭文件嵌套包含,比如:
a.h 代碼如下:

#include "b.h"

b.h 代碼如下:

#include "a.h"  

main.c 代碼如下:

#include "a.h"  

int main()  
{  
    return 0;
} 

編譯上面的例子,會出現如下錯誤:
這裏寫圖片描述
這裏寫圖片描述
爲了避免同一個文件被包含多次,C/C++中有兩種方式,一種是 #ifndef 方式,一種是 #pragma once 方式。在能夠支持這兩種方式的編譯器上,二者並沒有太大的區別,但是兩者仍然還是有一些細微的區別。

方式一:

#ifndef __FILENAME_H__  
#define __FILENAME_H__  

/* Variable or function declare */

#endif 

方式二:

#pragma once 

/* Variable or function declare */

#ifndef 的方式受 C/C++ 語言標準支持。它不光可以保證同一個文件不會被包含多次,也能保證內容完全相同的兩個文件(或者代碼片段)不會被不小心同時包含。

當然,缺點就是如果不同頭文件中的宏名不小心“撞車”,可能就會導致你看到頭文件明明存在,編譯器卻硬說找不到聲明的狀況——這種情況有時非常讓人抓狂,情況如下:
a.h 文件 #ifndef 中的宏爲 A_H

#ifndef __A_H__  
#define __A_H__  

#include "b.h"  

#endif 

b.h 文件 #ifndef 中的宏同樣爲 A_H

#ifndef __A_H__  
#define __A_H__  

#include "a.h"  

#endif  

結果編譯同樣錯誤,而且項目大了後,錯誤還不容易發現。

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

#pragma once 一般由編譯器提供保證:同一個文件不會被包含多次。注意這裏所說的“同一個文件”是指物理上的一個文件,而不是指內容相同的兩個文件。你無法對一個頭文件中的一段代碼作pragma once聲明,而只能針對文件。 其好處是,你不必再費勁想個宏名了,當然也就不會出現宏名碰撞引發的奇怪問題。大型項目的編譯速度也因此提高了一些。

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

#ifndef受C/C++語言標準的支持,不受編譯器的任何限制;而#pragma once方式卻不受一些較老版本的編譯器支持,一些支持了的編譯器又打算去掉它,所以它的兼容性可能不夠好。

還看到一種用法是把兩者放在一起的:

#pragma once  

#ifndef __SOMEFILE_H__  
#define __SOMEFILE_H__  

/* Variable or function declare */

#endif 

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

原文出處:這裏寫鏈接內容

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