標頭檔案多重包含

2021-06-28 04:40:38 字數 2045 閱讀 1331

#include檔案的乙個不利之處在於乙個標頭檔案可能會被多次包含,為了說明這種錯誤,#include "a.h" #include "b.h"  如果a.h和b.h都包含了乙個標頭檔案x.h。那麼x.h在此也同樣被包含了兩次,只不過它的形式不是那麼明顯而已。  多重包含在絕大多數情況下出現在大型程式中,它往往需要使用很多標頭檔案,因此要發現重複包含並不容易。

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

方式一:

#ifndef __somefile_h__

#define __somefile_h__

... ... // 宣告、定義語句

#endif

你必須記住預處理器仍將整個標頭檔案讀入,即使這個標頭檔案所有內容將被忽略。由於這種處理將託慢編譯速度,所以如果可能,應該避免出現多重包含。

重複包含可能導致巢狀包含,巢狀包含層次過深會導致編譯出錯。

標準要求編譯器必須支援至少8層的標頭檔案巢狀,事實上,我們沒有任何理由讓#include指令的巢狀深度超過一層或兩層。

方式二:

#pragma once

... ... // 宣告、定義語句

#ifndef的方式受c/c++語言標準支援。它不光可以保證同乙個檔案不會被包含多次,也能保證內容完全相同的兩個檔案(或者**片段)不會被不小心同時包含。

當然,缺點就是如果不同標頭檔案中的巨集名不小心「撞車」,可能就會導致你看到標頭檔案明明存在,編譯器卻硬說找不到宣告的狀況——這種情況有時非常讓人抓狂。

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

#pragma once一般由編譯器提供保證:同乙個檔案不會被包含多次。注意這裡所說的「同乙個檔案」是指物理上的乙個檔案,而不是指內容相同的兩個檔案。你無法對乙個標頭檔案中的一段**作pragma once宣告,而只能針對檔案。

其好處是,你不必再費勁想個巨集名了,當然也就不會出現巨集名碰撞引發的奇怪問題。大型專案的編譯速度也因此提高了一些。

對應的缺點就是如果某個標頭檔案有多份拷貝,本方法不能保證他們不被重複包含。當然,相比巨集名碰撞引發的「找不到宣告」的問題,這種重複包含很容易被發現並修正。

#pragma once方式產生於#ifndef之後,因此很多人可能甚至沒有聽說過。目前看來#ifndef更受到推崇。因為#ifndef受c/c++語言標準的支援,不受編譯器的任何限制;而#pragma once方式卻不受一些較老版本的編譯器支援,一些支援了的編譯器又打算去掉它,所以它的相容性可能不夠好。一般而言,當程式設計師聽到這樣的話,都會選擇#ifndef方式,為了努力使得自己的**「存活」時間更久,通常寧願降低一些編譯效能,這是程式設計師的個性,當然這是題外話啦。

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

#pragma once

#ifndef __somefile_h__

#define __somefile_h__

... ... // 宣告、定義語句

#endif

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

選擇哪種方式,應該在了解兩種方式的情況下,視具體情況而定。只要有乙個合理的約定來避開缺點,我認為哪種方式都是可以接受的。而這個已經不是標準或者編譯器的責任了,應當由程式設計師自己或者小範圍內的開發規範來搞定。

btw:我看到gnu的一些討論似乎是打算在gcc 3.4(及其以後?)的版本取消對#pragma once的支援。不過事實上,我手上的gcc 3.4.2和gcc 4.1.1仍然支援#pragma once,甚至沒有deprecation warning,倒是gcc2.95會對#pragma once提出warning。

vc6及其以後版本亦提供對#pragma once方式的支援,這一特性應該基本穩定下來了。

盡量合理規劃減少重複包含巢狀包含

避免標頭檔案的多重包含

通過預處理器變數,我們可以以標頭檔案保護符的形式避免在已經見到標頭檔案的情況下重新處理該標頭檔案的內容。使用預處理器變數作為標頭檔案保護符。預處理器變數有兩種狀態 已定義與未定義。define指示接受乙個名字並定義該名字為預處理器變數。ifndef指示檢測指定的預處理器變數是否未定義。如果預處理器變...

標頭檔案經常需要其他標頭檔案 避免多重包含

在編寫標頭檔案之前,我們需要引入一些額外的預處理器設施。預處理器允許 我們自定義變數。預處理器變數 的名字在程式中必須是唯一的。任何與預處理器 變數相匹配的名字的使用都關聯到該預處理器變數。為了避免名字衝突,預處理器變數經常用全大寫字母表示。預處理器變數有兩種狀態 已定義或未定義。定義預處理器變數和...

C 標頭檔案包含變數時,多重定義問題!

multiple definition of 在標頭檔案中.h中包含有變數定義的時候,一般是想作為全域性變數來使用,但是使用中總是出現multiple definition of的問題,看一下 oracleinfclass.h ifndef oracleinfclass h define oracl...