1. 程式人生 > >#pragma once 與 #ifndef 解析

#pragma once 與 #ifndef 解析

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

    方式二:
    #pragma once
    ... ... // 一些宣告語句

    #ifndef的方式依賴於巨集名字不能衝突,這不光可以保證同一個檔案不會被包含多次,也能保證內容完全相同的兩個檔案不會被不小心同時包含。當然,缺點就是如果不同標頭檔案的巨集名不小心“撞車”,可能就會導致標頭檔案明明存在,編譯器卻硬說找不到宣告的狀況——這種情況有時非常讓人抓狂。
    #pragma once則由編譯器提供保證:同一個檔案不會被包含多次。注意這裡所說的“同一個檔案”是指物理上的一個檔案,而不是指內容相同的兩個檔案。帶來的好處是,你不必再費勁想個巨集名了,當然也就不會出現巨集名碰撞引發的奇怪問題。對應的缺點就是如果某個標頭檔案有多份拷貝,本方法不能保證他們不被重複包含。當然,相比巨集名碰撞引發的“找不到宣告”的問題,重複包含更容易被發現並修正。
    #pragma once方式產生於#ifndef之後,因此很多人可能甚至沒有聽說過。目前看來#ifndef更受到推崇。因為#ifndef受語言天生的支援,不受編譯器的任何限制;而#pragma once方式卻不受一些較老版本的編譯器支援,換言之,它的相容性不夠好。也許,再過幾年等舊的編譯器死絕了,這就不是什麼問題了。
    我還看到一種用法是把兩者放在一起的:
    #pragma once
    #ifndef __SOMEFILE_H__
    #define __SOMEFILE_H__
    ... ... // 一些宣告語句
    #endif


    看起來似乎是想兼有兩者的優點。不過只要使用了#ifndef就會有巨集名衝突的危險,所以混用兩種方法似乎不能帶來更多的好處,倒是會讓一些不熟悉的人感到困惑。
    選擇哪種方式,應該在瞭解兩種方式的情況下,視具體情況而定。事實上,只要有一個合理的約定來避開缺點,我認為哪種方式都是可以接受的。而這個已經不是標準或者編譯器的責任了,應當由程式設計師來搞定。
    btw:我看到GNU的一些討論似乎是打算在GCC 3.4(及其以後?)的版本取消對#pragma once的支援。不過我手上GCC 3.4.2和GCC 4.1.1仍然支援#pragma once,甚至沒有deprecation warning。VC6及其以後版本亦提供對#pragma once方式的支援。看來這一特性已經穩定下來了。