#pragma

#pragma

在所有的預處理指令中,#pragma 指令可能是最複雜的了,它的作用是設定編譯器的狀態或者是指示編譯器完成一些特定的動作。#pragma指令對每個編譯器給出了一個方法,在保持與C和C++語言完全兼容的情況下,給出主機或作業系統專有的特徵。依據定義,編譯指示是機器或作業系統專有的,且對於每個編譯器都是不同的。

基本介紹

  • 中文名:#pragma
  • 性質:複雜
  • 特點:對每個編譯器給出了一個方法
  • 特點:對於每個編譯器都是不同的
一般格式,message 參數,code_seg,#pragma once,#pragma hdrstop,#pragma resource,#pragma warning,#pragma comment,#pragma disable,#pragma data_seg,#pragma region,套用實例(#pragma pack),

一般格式

其格式一般為: #pragma Para。其中Para 為參數,下面來看一些常用的參數
#pragma#pragma

message 參數

Message 參數能夠在編譯信息輸出視窗中輸出相應的信息,這對於原始碼信息的控制是非常重要的。其使用方法為:
#pragma message("訊息文本")
編譯器遇到這條指令時就在編譯輸出視窗中將訊息文本列印出來。
當我們在程式中定義了許多宏來控制原始碼版本的時候,我們自己有可能都會忘記有沒有正確的設定這些宏,此時我們可以用這條指令在編譯的時候就進行檢查。假設我們希望判斷自己有沒有在原始碼的什麼地方定義了_X86這個宏可以用下面的方法
#ifdef _X86#pragma message("_X86 macro activated!")#endif
當我們定義了_X86這個宏以後,應用程式在編譯時就會在編譯輸出視窗里顯示“_X86 macro activated! ”。我們就不會因為不記得自己定義的一些特定的宏而抓耳撓腮了。

code_seg

另一個使用得比較多的pragma參數是code_seg。格式如:
#pragma code_seg(["section-name"[,"section-class"]])
它能夠設定程式中函式代碼存放的代碼段,當我們開發驅動程式的時候就會使用到它。

#pragma once

(比較常用)
只要在頭檔案的最開始加入這條指令就能夠保證頭檔案被編譯一次,這條指令實際上在VC6中就已經有了,但是考慮到兼容性並沒有太多的使用它。
#pragma once是編譯相關,就是說這個編譯系統上能用,但在其他編譯系統不一定可以,也就是說移植性差,不過現在基本上已經是每個編譯器都有這個定義了。
#ifndef,#define,#endif這個是C++語言相關,這是C++語言中的宏定義,通過宏定義避免檔案多次編譯。所以在所有支持C++語言的編譯器上都是有效的,如果寫的程式要跨平台,最好使用這種方式

#pragma hdrstop

#pragma hdrstop表示預編譯頭檔案到此為止,後面的頭檔案不進行預編譯。BCB可以預編譯頭檔案以加快連結的速度,但如果所有頭檔案都進行預編譯又可能占太多磁碟空間,所以使用這個選項排除一些頭檔案。
有時單元之間有依賴關係,比如單元A依賴單元B,所以單元B要先於單元A編譯。你可以用#pragma startup指定編譯優先權,如果使用了#pragma package(smart_init) ,BCB就會根據優先權的大小先後編譯。

#pragma resource

#pragma resource "*.dfm"表示把*.dfm檔案中的資源加入工程。*.dfm中包括窗體外觀的定義。

#pragma warning

#pragma warning(disable:450734;once:4385;error:164)
等價於:
#pragma warning(disable:450734)//不顯示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)。

#pragma comment

#pragma comment(...)
該指令將一個注釋記錄放入一個對象檔案或執行檔中。
常用的lib關鍵字,可以幫我們連入一個庫檔案
每個編譯程式可以用#pragma指令激活或終止該編譯程式支持的一些編譯功能。例如,對循環最佳化功能:
#pragma loop_opt(on)//激活#pragma loop_opt(off)//終止
有時,程式中會有些函式會使編譯器發出你熟知而想忽略的警告,如“Parameter xxx is never used in function xxx”,可以這樣:
#pragma warn—100//Turnoffthewarningmessageforwarning#100intinsert_record(REC*r){/*functionbody*/}#pragma warn+100//Turnthewarningmessageforwarning#100backon
函式會產生一條有唯一特徵碼100的警告信息,如此可暫時終止該警告。
每個編譯器對#pragma的實現不同,在一個編譯器中有效在別的編譯器中幾乎無效。可從編譯器的文檔中查看。
#pragma pack(n)和#pragma pop()struct sample{char a;double b;};
當sample結構沒有加#pragma pack(n)的時候,sample按最大的成員那個對齊;
(所謂的對齊是指對齊數為n時,對每個成員進行對齊,既如果成員a的大小小於n則將a擴大到n個大小;
如果a的大小大於n則使用a的大小;)所以上面那個結構的大小為16位元組.
當sample結構加#pragma pack(1)的時候,sizeof(sample)=9位元組;無空位元組。
(另註:當n大於sample結構的最大成員的大小時,n取最大成員的大小。
所以當n越大時,結構的速度越快,大小越大;反之則)
#pragma apop()就是取消#pragma pack(n)的意思了,也就是說接下來的結構不用#pragma pack(n)
#pragma comment(comment-type,["commentstring"])
comment-type是一個預定義的標識符,指定注釋的類型,應該是compiler,exestr,lib,linker之一。
comment string是一個提供為comment-type提供附加信息的字元串。
注釋類型:
1、compiler:
放置編譯器的版本或者名字到一個對象檔案,該選項是被linker忽略的。
2、exestr:
在以後的版本將被取消。
3、lib:
放置一個庫搜尋記錄到對象檔案中,這個類型應該是和comment string(指定你要Linker搜尋的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 disable


在函式前聲明,只對一個函式有效。該函式調用過程中將不可被中斷。一般在C51中使用較多。

#pragma data_seg

介紹
用#pragma data_seg建立一個新的數據段並定義共享數據,其具體格式為:
#pragma data_seg("shareddata")HWNDsharedwnd=NULL;//共享數據#pragma data_seg()
-----------------------------------------------------------------
1,#pragma data_seg()一般用於DLL中。也就是說,在DLL中定義一個共享的有名字的數據段。最關鍵的是:這個數據段中的全局變數可以被多個進程共享,否則多個進程之間無法共享DLL中的全局變數。
2,共享數據必須初始化,否則微軟編譯器會把沒有初始化的數據放到.BSS段中,從而導致多個進程之間的共享行為失敗。例如,
#pragma data_seg("MyData")intg_Value;//Notethattheglobalisnotinitialized.#pragma data_seg()//DLL提供兩個接口函式:int GetValue(){    return g_Value;}void SetValue(int n){    g_Value=n;}
然後啟動兩個進程A和B,A和B都調用了這個DLL,假如A調用了SetValue(5); B接著調用int m = GetValue(); 那么m的值不一定是5,而是一個未定義的值。因為DLL中的全局數據對於每一個調用它的進程而言,是私有的,不能共享的。假如你對g_Value進行了初始化,那么g_Value就一定會被放進MyData段中。換句話說,如果A調用了SetValue(5); B接著調用int m = GetValue(); 那么m的值就一定是5,這就實現了跨進程之間的數據通信。

#pragma region

#pragma region是Visual C++中特有的預處理指令。它可以讓你摺疊特定的代碼塊,從而使界面更加清潔,便於編輯其他代碼。摺疊後的代碼塊不會影響編譯。你也可以隨時展開代碼塊以進行編輯等操作。
格式:
#pragma region name#pragma endregion comment
使用示例如下:
#pragma region VariablesHWND hWnd;const size_t Max_Length = 20;//other variables#pragma endregion This region contains global variables.
如上邊所示,需要摺疊的代碼必須包含在#pragma region和#pragma endregion之間。#pragma region和#pragma endregion之後可以添加一些用來注釋的文字。當你摺疊代碼塊後,這些文字會顯示在摺疊的位置。
摺疊代碼塊的方法:如同Visual C++中摺疊函式、類、命名空間,當代碼被包含在如上所述的指令之間後,#pragma region這一行的左邊會出現一個“-”號,單擊以摺疊內容,同時“-”號會變成“+”號,再次單擊可以展開代碼塊。
此預編譯指令在Visual Studio 2005及以上版本可以使用。但是在Visual Studio 2005中,當#pragma region之後包含類似“1st”這類的文字,會導致“error C2059: syntax error : 'bad suffix on number'”的編譯錯誤。避免使用數字或者將數字與字母分離可以解決這個問題。

套用實例(#pragma pack)

網路協定編程中,經常會處理不同協定的數據報文。一種方法是通過指針偏移的方法來得到各種信息,但這樣做不僅編程複雜,而且一旦協定有變化,程式修改起來也比較麻煩。在了解了編譯器對結構空間的分配原則之後,我們完全可以利用這一特性定義自己的協定結構,通過訪問結構的成員來獲取各種信息。這樣做,不僅簡化了編程,而且即使協定發生變化,我們也只需修改協定結構的定義即可,其它程式無需修改,省時省力。下面以TCP協定首部為例,說明如何定義協定結構。
其協定結構定義如下:
#pragma pack(1)//按照1位元組方式進行對齊struct TCPHEADER{shortSrcPort;//16位源連線埠號shortDstPort;//16位目的連線埠號intSerialNo;//32位序列號intAckNo;//32位確認號unsignedcharHaderLen:4;//4位首部長度unsignedcharReserved1:4;//保留16位中的4位unsignedcharReserved2:2;//保留16位中的2位unsignedcharURG:1;unsignedcharACK:1;unsignedcharPSH:1;unsignedcharRST:1;unsignedcharSYN:1;unsignedcharFIN:1;shortWindowSize;//16位視窗大小shortTcpChkSum;//16位TCP檢驗和shortUrgentPointer;//16位緊急指針};#pragm apop()//取消1位元組對齊方式
#pragma pack規定的對齊長度,實際使用的規則是: 結構,聯合,或者類的數據成員,第一個放在偏移為0的地方,以後每個數據成員的對齊,按照#pragma pack指定的數值和這個數據成員自身長度中,比較小的那個進行。 但是,當#pragma pack的值等於或超過最長數據成員的長度的時候,這個值的大小將不產生任何效果。 而結構整體的對齊,則按照結構體中最大的數據成員進行。

相關詞條

熱門詞條

聯絡我們