pragma預處理指令
阿新 • • 發佈：2019-02-18
在所有的預處理指令中，#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關鍵字，可以幫我們連入一個庫檔案。
（8）·通過#pragma pack(n)改變C編譯器的位元組對齊方式
在C語言中，結構是一種複合資料型別，其構成元素既可以是基本資料型別（如int、long、float等）的變數，也可以是一些複合資料型別（如陣列、結構、聯合等）的資料單元。在結構中，編譯器為結構的每個成員按其自然對界（alignment）條件分配空間。各個成員按照它們被宣告的順序在記憶體中順序儲存，第一個成員的地址和整個結構的地址相同。
例如，下面的結構各成員空間分配情況：
struct test
{
char x1;
short x2;
float x3;
char x4;
};
結構的第一個成員x1，其偏移地址為0，佔據了第1個位元組。第二個成員x2為short型別，其起始地址必須2位元組對界，因此，編譯器在x2和x1之間填充了一個空位元組。結構的第三個成員x3和第四個成員x4恰好落在其自然對界地址上，在它們前面不需要額外的填充位元組。在test結構中，成員x3要求4位元組對界，是該結構所有成員中要求的最大對界單元，因而test結構的自然對界條件為4位元組，編譯器在成員x4後面填充了3個空位元組。整個結構所佔據空間為 12位元組。更改C編譯器的預設位元組對齊方式
在預設情況下，C編譯器為每一個變數或是資料單元按其自然對界條件分配空間。一般地，可以通過下面的方法來改變預設的對界條件：
· 使用偽指令#pragma pack (n)，C編譯器將按照n個位元組對齊。
· 使用偽指令#pragma pack ()，取消自定義位元組對齊方式。
另外，還有如下的一種方式：
· __attribute((aligned (n)))，讓所作用的結構成員對齊在n位元組自然邊界上。如果結構中有成員的長度大於n，則按照最大成員的長度來對齊。
· __attribute__ ((packed))，取消結構在編譯過程中的優化對齊，按照實際佔用位元組數進行對齊。
以上的n = 1, 2, 4, 8, 16... 第一種方式較為常見。
應用例項
在網路協議程式設計中，經常會處理不同協議的資料報文。一種方法是通過指標偏移的方法來得到各種資訊，但這樣做不僅程式設計複雜，而且一旦協議有變化，程式修改起來也比較麻煩。在瞭解了編譯器對結構空間的分配原則之後，我們完全可以利用這一特性定義自己的協議結構，通過訪問結構的成員來獲取各種資訊。這樣做，不僅簡化了程式設計，而且即使協議發生變化，我們也只需修改協議結構的定義即可，其它程式無需修改，省時省力。下面以TCP協議首部為例，說明如何定義協議結構。其協議結構定義如下：
#pragma pack(1) // 按照1位元組方式進行對齊
struct TCPHEADER
{
short SrcPort; // 16位源埠號
short DstPort; // 16位目的埠號
int SerialNo; // 32位序列號
int AckNo; // 32位確認號
unsigned char HaderLen : 4; // 4位首部長度
unsigned char Reserved1 : 4; // 保留6位中的4位
unsigned char Reserved2 : 2; // 保留6位中的2位
unsigned char URG : 1;
unsigned char ACK : 1;
unsigned char PSH : 1;
unsigned char RST : 1;
unsigned char SYN : 1;
unsigned char FIN : 1;
short WindowSize; // 16位視窗大小
short TcpChkSum; // 16位TCP檢驗和
short UrgentPointer; // 16位緊急指標
};
#pragma pack() // 取消1位元組對齊方式
其格式一般為: #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關鍵字，可以幫我們連入一個庫檔案。
（8）·通過#pragma pack(n)改變C編譯器的位元組對齊方式
在C語言中，結構是一種複合資料型別，其構成元素既可以是基本資料型別（如int、long、float等）的變數，也可以是一些複合資料型別（如陣列、結構、聯合等）的資料單元。在結構中，編譯器為結構的每個成員按其自然對界（alignment）條件分配空間。各個成員按照它們被宣告的順序在記憶體中順序儲存，第一個成員的地址和整個結構的地址相同。
例如，下面的結構各成員空間分配情況：
struct test
{
char x1;
short x2;
float x3;
char x4;
};
結構的第一個成員x1，其偏移地址為0，佔據了第1個位元組。第二個成員x2為short型別，其起始地址必須2位元組對界，因此，編譯器在x2和x1之間填充了一個空位元組。結構的第三個成員x3和第四個成員x4恰好落在其自然對界地址上，在它們前面不需要額外的填充位元組。在test結構中，成員x3要求4位元組對界，是該結構所有成員中要求的最大對界單元，因而test結構的自然對界條件為4位元組，編譯器在成員x4後面填充了3個空位元組。整個結構所佔據空間為 12位元組。更改C編譯器的預設位元組對齊方式
在預設情況下，C編譯器為每一個變數或是資料單元按其自然對界條件分配空間。一般地，可以通過下面的方法來改變預設的對界條件：
· 使用偽指令#pragma pack (n)，C編譯器將按照n個位元組對齊。
· 使用偽指令#pragma pack ()，取消自定義位元組對齊方式。
另外，還有如下的一種方式：
· __attribute((aligned (n)))，讓所作用的結構成員對齊在n位元組自然邊界上。如果結構中有成員的長度大於n，則按照最大成員的長度來對齊。
· __attribute__ ((packed))，取消結構在編譯過程中的優化對齊，按照實際佔用位元組數進行對齊。
以上的n = 1, 2, 4, 8, 16... 第一種方式較為常見。
應用例項
在網路協議程式設計中，經常會處理不同協議的資料報文。一種方法是通過指標偏移的方法來得到各種資訊，但這樣做不僅程式設計複雜，而且一旦協議有變化，程式修改起來也比較麻煩。在瞭解了編譯器對結構空間的分配原則之後，我們完全可以利用這一特性定義自己的協議結構，通過訪問結構的成員來獲取各種資訊。這樣做，不僅簡化了程式設計，而且即使協議發生變化，我們也只需修改協議結構的定義即可，其它程式無需修改，省時省力。下面以TCP協議首部為例，說明如何定義協議結構。其協議結構定義如下：
#pragma pack(1) // 按照1位元組方式進行對齊
struct TCPHEADER
{
short SrcPort; // 16位源埠號
short DstPort; // 16位目的埠號
int SerialNo; // 32位序列號
int AckNo; // 32位確認號
unsigned char HaderLen : 4; // 4位首部長度
unsigned char Reserved1 : 4; // 保留6位中的4位
unsigned char Reserved2 : 2; // 保留6位中的2位
unsigned char URG : 1;
unsigned char ACK : 1;
unsigned char PSH : 1;
unsigned char RST : 1;
unsigned char SYN : 1;
unsigned char FIN : 1;
short WindowSize; // 16位視窗大小
short TcpChkSum; // 16位TCP檢驗和
short UrgentPointer; // 16位緊急指標
};
#pragma pack() // 取消1位元組對齊方式