#pragma 指
#pragma 指令學習
在所有預處理命令當中，#pragma 指令可能是最複雜的了，它的作用是設定編譯器的狀態或則指示編譯
器完成一些特定的動作，#pragma 指令對每個編譯器給出了一個方法，在保持與C 和C++語言完全兼容的
情況下，給出主機或操作系統專有的特徵，依據定義，編譯指示是機器或則操作系統專有的，且對每個
編譯器都是不同的。
其格式一般是： #pragma paramenter
其中： paramenter 是參數
（1） message 參數： 它能夠在編譯信息輸出窗口中輸出相應的信息，
這對於源代碼信息的控制是非常重要的，使用方法是：
#pragma message("消息文本")
當編譯器遇到這條指令的時候就在編譯信息輸出窗口輸出相應的信息,把消息文本打印出來.
當我們在程序中定義了許多宏來控制源代碼版本的時候,我們自己有可能都會忘記有沒有正確設置這些宏,
此時我們可以用這條指令在編譯的時候就進行檢查,假設我們希望判斷自己有沒有在源代碼的什麼地方定義了 _X86這個
宏可以使用下面的方法:
#ifdef _X86
#pragma message("_X86 macro activited")
#endif
如果我們定義了_X86這個宏,應用程序在編譯是就會在編譯輸出框顯示:"_X86 macro activited",我們
就不會因爲自己不記得是否定義而苦惱了.
(2) 另外一個使用得比較多的pragma 參數是code_seg 格式如:
#pragma code_seg ([[{push|pop},][identifier,]]["section-name"["sectin class"]])
它能夠設置程序中函數代碼存放的代碼段(位置).(另注:該參數可以用來指定在*.obj 文件中存放的節,
觀察 *.obj可以使用VC自帶的dumpbin命令行程序,函數在*.obj文件中默認的存放字節是 .text節.
如果code_seg 沒有帶參數的話,則函數存放在 .text節
push [可選參數] 將一個記錄放到內部編譯器的堆棧中,可選參數 identifier可以是一個標識符或者節名.
pop [可選參數] 將一個記錄從堆棧的頂端彈出,可選參數 identifier 可以爲一個標識符或者節名.
可選參數 identifier,當使用PUSH指令時候,爲壓入堆棧的記錄指派一個標識符,當該標識符被刪除的時候和
其相關的堆棧中的記錄將被彈出堆棧.
"segment-name" [可選參數] 表示函數存放的節名.
例如:
默認情況下,函數被存放在.text中,
void func1(){ //stored in .text
}
將函數存放到節 .my data中
#pragma code_seg(".my data1")
void func2()[ stored in my data
}
//r1爲標誌符,將函數放入.my data2節中
#pragma code_seg (push,r1,".my data2")
void func3(){ //stored in my data2
}
(3) #pragma once 這是一個比較常用的指令,只要在頭文件的最開始加入這條指令就能夠保證頭文件被編譯一次.
這條指令在VC6裏面就有,要考慮到兼容性.
(4) #pragma hdrstop 表示預編譯到次爲止,對後面的頭文件不在進行預編譯.
BCB可以預編譯頭文件加快鏈接的速度,但是如果所有頭文件都進行預編譯可能佔有太多磁盤空間,所以使用
這個選項排除一些頭文件.
有時候單元之間有依賴關係,比如單元A依賴單元B,所以單元B要先於單元A編譯. 可以用#pragma startup 指定編譯優先級.
如果使用了#pragma package(smart_init),BCB就會根據優先級的大小先後編譯.
(5) #pragma warning 指令
該指令允許有選擇性的修改編譯器的警告信息行爲.
指令格式:
#pragma warning(warning)specifier;warning-number-list[;warning-specifier;warning-number-list..]
#pragma warning(push[n])
#pragma warning(pop)
主要用到的警告表示有如下幾個:
once:只顯示一次(警告/錯誤等)消息
default:重置編譯器的警告行爲到默認狀態.
1,2,3,4:四個警告級別
disable:禁止指定的警告信息.
error:將指定的警告信息認爲是錯誤.
#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)
#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)
在使用標準C++進行編程的時候經常會得到很多的警告信息,而這些警告信息都是不必要的提示,
所以我們可以使用#pragma warning(disable:4786)來禁止該類型的警告
在vc中使用ADO的時候也會得到不必要的警告信息,這個時候我們可以通過
#pragma warning(disable:4146)來消除該類型的警告信息
(6)#pragma comment(...)
#pragma comment("comment-type"[,commentstring])
該指令將一個註釋記錄放入一個對象文件或可執行文件中 comment-type 類型 one of the five
compiler:將編譯器的版本號和名稱放入目標文件中，本條註釋記錄將被編譯器忽略，如果你爲該記錄類型
提供了commentstring 參數，編譯器將產生一個警告，
EX： #pragma comment (compiler)
exestr:將commentstring 參數放入目標文件中，在鏈接的時候這個字符串將被放入到可執行文件中，當操
作系統加載可執行文件時，該參數字符串不會被加載到內存中，但是，該參數字符串可以被dumpbin之類的的
程序查找並打印出來，你可以用這個標誌符號將版本之類的信息潛入到可執行文件中。
lib:這是一個非常常用的關鍵字，可以幫我們連入一個庫文件到目標文件。
ex:
#pragma comment(lib,"userlib.lib")
linker:
將一個鏈接選項放入目標文件中，你可以使用這個指令來代替命令行傳入的或則在開發環境中設置的鏈接
選項，你可以指定/include 選項來強制包含某個對象
ex:
#pragma comment(linker,"/include:_mySymbol")
你可以在程序中設置下列鏈接選項：
/DEFAULTLIB
/EXPORT
/INCLUDE
/MERGE
/SECTION
詳情請參考msdn
user: 將一般的註釋信息放入目標文件中，commentstring 參數包含註釋的文本信息，這個註釋記錄將被
鏈接器忽略。
ex:
#pragma comment(user,"compiled on " _DATE" at "_TIMER_")
使用#pragma 導出 DLL 函數
傳統的導出DLL函數的方法是使用模塊定義文件(.def),Visual C++ 提供了更簡潔方便的方法,那就
是"_declspec()" 關鍵字後面跟"dllexport",告訴鏈接去導出這個函數.
例如 :
_declspec(dllexport) int _stdcall MyExportFunction(int iTest);
把"__declspec(dllexport)"放在最前面聲明,連接生成的DLL 就會導出函數"_MyExportFunction@4".
上面導出的函數名稱也許不是我們希望的,我們希望導出原版"的"MyExportFunction". 可以指定用VC
提供的"#pragma"指令來指定鏈接選項.
ex:
#pragma comment(linker,"/EXPORT:MyExportFunction=_MyExportFunction@4")
原形: /EXPORT:entryname[,@ordinal[,NONAME]][,DATA]
@ordinal 指定順序;NONAME 指定只將函數導出爲序號;DATA關鍵字指定導出項爲數據項.