儘管 C 和 C++ 都已經有標準,但是幾乎每個編譯器 (廣義,包含聯結器等) 擴充套件一些 C/C++ 關鍵字。
合理地應用這些關鍵字,有時候能使我們的工作非常方便。下面隨便說說 Visual C++ 中 #pragma
指示符的使用。
一、用#pragma匯出DLL函式
傳統的到出 DLL 函式的方法是使用模組定義檔案 (.def),Visual C++ 提供了更簡潔方便的方法,
那就是“__declspec()”關鍵字後面跟“dllexport”,告訴連線去要匯出這個函式,例如:
__declspec(dllexport) int __stdcall MyExportFunction(int iTest);
把“__declspec(dllexport)”放在函式宣告的最前面,連線生成的 DLL 就會匯出函式
“_MyExportFunction@4”。
上面的匯出函式的名稱也許不是我的希望的,我們希望匯出的是原版的“MyExportFunction”。
還好,VC 提供了一個預處理指示符“#pragma”來指定連線選項 (不僅僅是這一個功能,還有很多指示功能) ,
如下:
#pragma comment(linker,"/EXPORT:MyExportFunction=_MyExportFunction@4")
這下就天如人願了:)。如果你想指定匯出的順序,或者只將函式匯出為序號,沒有 Entryname,
這個預處理指示符 (確切地說是聯結器) 都能夠實現,看看 MSDN 的語法說明:
/EXPORT:entryname[,@ordinal[,NONAME]][,DATA]
@ordinal 指定順序;NONAME 指定只將函式匯出為序號;DATA 關鍵字指定匯出項為資料項。
二、指示檔案只包含一次
在標頭檔案中,一般在整個工程中我們只要包含一次就夠了,但是如果我在多個 .c/.cpp 檔案中都要包
含著個標頭檔案,比如 Windows.h,那很多宣告等等豈不是有兩次了?解決這個問題的傳統的方法是在標頭檔案
開始出用
#define 定義一個宏,比如 Windows.h 中:
#ifndef _WINDOWS_#define _WINDOWS_
P> 然後在檔案結為加上 #endif,這樣就可以避免被包含多次。但是這樣的後果是程式碼的可讀性較差
(個人觀點),VC 給我們提供了另外一個途徑,那就是在檔案的前面加上:#pragma once 是不是很方便?
三、使警告無效 有時候我們不得不對變數進行強制轉換,由此引來編譯器的一番警告,特別是 C++ 中
,型別檢查相對於 C 更為嚴格。這雖然不影響什麼,但是看起來多不爽——我是故意要這樣的,
你警告什麼!:)這時候你看到警告型別,
比如“warning C4311: “型別轉換” : 從“HHOOK”到“BOOL”的指標截斷”,在前面加上:
#pragma warning(disable: 4311) 編譯器就沒話說了:)。
四、指定連線要使用的庫 比如我們連線的時候用到了 WSock32.lib,你當然可以
不辭辛苦地把它加入到你的工程中。但是我覺得更方便的方法是使用 #pragma 指示符,指定要連線的庫:
#pragma comment(lib, "WSock32.lib")五、顯示編譯訊息 沒多少用處,舉個例子吧:
#ifdef _DEBUG#pragma message
("編譯連線為除錯模式...")#endif // _DEBUG
在所有的預處理指令中,#Pragma 指令可能是最複雜的了,它的作用是設定編譯器的狀態或者是指示
編譯器完成一些特定的動作。#pragma
指令對每個編譯器給出了一個方法,在保持與C和C++語言完全相容的情況下,給出主機或作業系統專有
的特徵。依據定義,編譯指示是機器或作業系統專有的,且對於每個編譯器都是不同的。
其格式一般為: #Pragma Para
其中Para 為引數,下面來看一些常用的引數。
(1)message 引數。 Message 引數是我最喜歡的一個引數,它能夠在編譯資訊輸出窗
口中輸出相應的資訊,這對於原始碼資訊的控制是非常重要的。其使用方法為:
#Pragma message(“訊息文字”)
當編譯器遇到這條指令時就在編譯輸出視窗中將訊息文字列印出來。
當我們在程式中定義了許多宏來控制原始碼版本的時候,我們自己有可能都會忘記有沒有正確的設
置這些宏,此時我們可以用這條指令在編譯的時候就進行檢查。假設我們希望判斷自己有沒有在源
程式碼的什麼地方定義了
_X86這個宏可以用下面的方法
#ifdef _X86
#Pragma message(“_X86 macro activated!”)
#endif
當我們定義了_X86這個宏以後,應用程式在編譯時就會在編譯輸出視窗裡顯示“_
X86 macro activated!”。我們就不會因為不記得自己定義的一些特定的宏而抓耳撓腮了
。
(2)另一個使用得比較多的pragma引數是code_seg。格式如:
#pragma code_seg( ["section-name"[,"section-class"] ] )
它能夠設定程式中函式程式碼存放的程式碼段,當我們開發驅動程式的時候就會使用到它。
(3)#pragma once (比較常用)
只要在標頭檔案的最開始加入這條指令就能夠保證標頭檔案被編譯一次,這條指令實際上在VC6中就已經有了,
但是考慮到相容性並沒有太多的使用它。
(4)#pragma hdrstop表示預編譯標頭檔案到此為止,後面的標頭檔案不進行預編譯。BCB可以預編譯標頭檔案以加
快連結的速度,但如果所有標頭檔案都進行預編譯又可能佔太多磁碟空間,所以使用這個選項排除一些標頭檔案。
有時單元之間有依賴關係,比如單元A依賴單元B,所以單元B要先於單元A編譯。你可以用
#pragma startup指定編譯優先順序,如果使用了#pragma package(smart_init) ,BCB就會根據優先順序的
大小先後編譯。
(5)#pragma resource "*.dfm"表示把*.dfm檔案中的資源加入工程。*.dfm中包括窗體
外觀的定義。
(6)#pragma warning( disable : 4507 34; once : 4385; error : 164 )
等價於:
#pragma warning(disable:4507 34) // 不顯示4507和34號警告資訊
#pragma warning(once:4385) // 4385號警告資訊僅報告一次
#pragma warning(error:164) // 把164號警告資訊作為一個錯誤。
同時這個pragma warning 也支援如下格式:
#pragma warning( push [ ,n ] )
#pragma warning( pop )
這裡n代表一個警告等級(1---4)。
#pragma warning( push )儲存所有警告資訊的現有的警告狀態。
#pragma warning( push, n)儲存所有警告資訊的現有的警告狀態,並且把全域性警告
等級設定為n。
#pragma warning( pop )向棧中彈出最後一個警告資訊,在入棧和出棧之間所作的
一切改動取消。例如:
#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
//.......
#pragma warning( pop )
在這段程式碼的最後,重新儲存所有的警告資訊(包括4705,4706和4707)。
(7)pragma comment(...)
該指令將一個註釋記錄放入一個物件檔案或可執行檔案中。
常用的lib關鍵字,可以幫我們連入一個庫檔案。
#pragma comment( comment-type [,"commentstring"] )
comment-type是一個預定義的識別符號,指定註釋的型別,應該是compiler,exestr,lib,linker之一。
commentstring是一個提供為comment-type提供附加資訊的字串,
Remarks:
1、compiler:放置編譯器的版本或者名字到一個物件檔案,該選項是被linker忽略的。
2、exestr:在以後的版本將被取消。
3、lib:放置一個庫搜尋記錄到物件檔案中,這個型別應該是和commentstring(指定你要Liner搜尋的lib的名稱和路徑)
這個庫的名字放在Object檔案的預設庫搜尋記錄的後面,linker搜尋這個這個庫就像你在命令列輸入這個命令一樣。你可以
在一個原始檔中設定多個庫記錄,它們在object檔案中的順序和在原始檔中的順序一樣。如果預設庫和附加庫的次序是需要
區別的,使用Z編譯開關是防止預設庫放到object模組。
4、linker:指定一個連線選項,這樣就不用在命令列輸入或者在開發環境中設定了。
只有下面的linker選項能被傳給Linker.
-
/DEFAULTLIB
-
/EXPORT
-
/INCLUDE
-
/MANIFESTDEPENDENCY
-
/MERGE
-
/SECTION
(1)/DEFAULTLIB:library
/DEFAULTLIB 選項將一個 library 新增到 LINK 在解析引用時搜尋的庫列表。用 /DEFAULTLIB 指定的庫在命令列上指定的庫之後和 .obj 檔案中指定的預設庫之前被搜尋。
忽略所有預設庫 (/NODEFAULTLIB) 選項重寫 /DEFAULTLIB:library。如果在兩者中指定了相同的 library 名稱,忽略庫 (/NODEFAULTLIB:library) 選項將重寫 /DEFAULTLIB:library。
(2)/EXPORT:entryname[,@ordinal[,NONAME]][,DATA]
使用該選項,可以從程式匯出函式,以便其他程式可以呼叫該函式。也可以匯出資料。通常在 DLL 中定義匯出。entryname 是呼叫程式要使用的函式或資料項的名稱。ordinal 在匯出表中指定範圍在 1 至 65,535 的索引;如果沒有指定 ordinal,則 LINK 將分配一個。NONAME 關鍵字只將函式匯出為序號,沒有 entryname。
DATA 關鍵字指定匯出項為資料項。客戶程式中的資料項必須用 extern __declspec(dllimport) 來宣告。
有三種匯出定義的方法,按照建議的使用順序依次為:
-
原始碼中的 __declspec(dllexport)
-
.def 檔案中的 EXPORTS 語句
-
LINK 命令中的 /EXPORT 規範
所有這三種方法可以用在同一個程式中。LINK 在生成包含匯出的程式時還建立匯入庫,除非生成中使用了 .exp 檔案。
LINK 使用識別符號的修飾形式。編譯器在建立 .obj 檔案時修飾識別符號。如果 entryname 以其未修飾的形式指定給連結器(與其在原始碼中一樣),則 LINK 將試圖匹配該名稱。如果無法找到唯一的匹配名稱,則 LINK 發出錯誤資訊。當需要將識別符號指定給連結器時,請使用 Dumpbin 工具獲取該識別符號的修飾名形式。
(3)/INCLUDE:symbol
/INCLUDE 選項通知連結器將指定的符號新增到符號表。
若要指定多個符號,請在符號名稱之間鍵入逗號 (,)、分號 (;) 或空格。在命令列上,對每個符號指定一次 /INCLUDE:symbol。
連結器透過將包含符號定義的物件新增到程式來解析 symbol。該功能對於添包含不會連結到程式的庫物件非常有用。用該選項指定符號將透過 /OPT:REF 重寫該符號的移除。
我們經常用到的是#pragma comment(lib,"*.lib")這類的。
#pragma comment(lib,"Ws2_32.lib")表示連結Ws2_32.lib這個庫。
和在工程設定裡寫上鍊入Ws2_32.lib的效果一樣,不過這種方法寫的
程式別人在使用你的程式碼的時候就不用再設定工程settings了
原文:pragma comment的使用(轉)