pragma 預(yù)處理指令詳解
2008-05-21 11:00
pragma指令簡(jiǎn)介
在編寫程序的時(shí)候,我們經(jīng)常要用到#pragma指令來(lái)設(shè)定編譯器的狀態(tài)或者是指示編譯器完成一些特定的動(dòng)作.
下面介紹了一下該指令的一些常用參數(shù),希望對(duì)大家有所幫助!
一. message 參數(shù)。
message
它能夠在編譯信息輸出窗
口中輸出相應(yīng)的信息，這對(duì)于源代碼信息的控制是非常重要的。其使用方法為：
#pragma message(“消息文本”)
當(dāng)編譯器遇到這條指令時(shí)就在編譯輸出窗口中將消息文本打印出來(lái)。
當(dāng)我們?cè)诔绦蛑卸x了許多宏來(lái)控制源代碼版本的時(shí)候，我們自己有可能都會(huì)忘記有沒(méi)有正確的設(shè)置這些宏，此時(shí)我們可以用這條
指令在編譯的時(shí)候就進(jìn)行檢查。假設(shè)我們希望判斷自己有沒(méi)有在源代碼的什么地方定義了_X86這個(gè)宏可以用下面的方法
#ifdef _X86
#pragma message(“_X86 macro activated!”)
#endif
當(dāng)我們定義了_X86這個(gè)宏以后，應(yīng)用程序在編譯時(shí)就會(huì)在編譯輸出窗口里顯示“_
X86 macro activated!”。我們就不會(huì)因?yàn)椴挥浀米约憾x的一些特定的宏而抓耳撓腮了
二. 另一個(gè)使用得比較多的#pragma參數(shù)是code_seg。格式如：
#pragma code_seg( [ [ { push | pop}, ] [ identifier, ] ] [ "segment-name" [, "segment-class" ] )
該指令用來(lái)指定函數(shù)在.obj文件中存放的節(jié),觀察OBJ文件可以使用VC自帶的dumpbin命令行程序,函數(shù)在.obj文件中默認(rèn)的存放節(jié)
為.text節(jié)
如果code_seg沒(méi)有帶參數(shù)的話,則函數(shù)存放在.text節(jié)中
push (可選參數(shù)) 將一個(gè)記錄放到內(nèi)部編譯器的堆棧中,可選參數(shù)可以為一個(gè)標(biāo)識(shí)符或者節(jié)名
pop(可選參數(shù)) 將一個(gè)記錄從堆棧頂端彈出,該記錄可以為一個(gè)標(biāo)識(shí)符或者節(jié)名
identifier (可選參數(shù)) 當(dāng)使用push指令時(shí),為壓入堆棧的記錄指派的一個(gè)標(biāo)識(shí)符,當(dāng)該標(biāo)識(shí)符被刪除的時(shí)候和其相關(guān)的堆棧中的記錄將被彈出堆棧
"segment-name" (可選參數(shù)) 表示函數(shù)存放的節(jié)名
例如:
//默認(rèn)情況下,函數(shù)被存放在.text節(jié)中
void func1() { // stored in .text
}
//將函數(shù)存放在.my_data1節(jié)中
#pragma code_seg(".my_data1")
void func2() { // stored in my_data1
}
//r1為標(biāo)識(shí)符,將函數(shù)放入.my_data2節(jié)中
#pragma code_seg(push, r1, ".my_data2")
void func3() { // stored in my_data2
}
int main() {
}
三. #pragma once (比較常用）
這是一個(gè)比較常用的指令,只要在頭文件的最開(kāi)始加入這條指令就能夠保證頭文件被編譯一次
四. #pragma hdrstop表示預(yù)編譯頭文件到此為止，后面的頭文件不進(jìn)行預(yù)編譯。
BCB可以預(yù)編譯頭文件以加快鏈接的速度，但如果所有頭文件都進(jìn)行預(yù)編譯又可能占太多磁盤空間，所以使用這個(gè)選項(xiàng)排除一些頭文件。
有時(shí)單元之間有依賴關(guān)系，比如單元A依賴單元B，所以單元B要先于單元A編譯。你可以用#pragma startup指定編譯優(yōu)先級(jí)，
如果使用了#pragma package(smart_init) ，BCB就會(huì)根據(jù)優(yōu)先級(jí)的大小先后編譯。
五. #pragma warning指令
該指令允許有選擇性的修改編譯器的警告消息的行為
指令格式如下:
#pragma warning( warning-specifier : warning-number-list [; warning-specifier : warning-number-list...]
#pragma warning( push[ ,n ] )
#pragma warning( pop )
主要用到的警告表示有如下幾個(gè):
once:只顯示一次(警告/錯(cuò)誤等)消息
default:重置編譯器的警告行為到默認(rèn)狀態(tài)
1,2,3,4:四個(gè)警告級(jí)別
disable:禁止指定的警告信息
error:將指定的警告信息作為錯(cuò)誤報(bào)告
如果大家對(duì)上面的解釋不是很理解,可以參考一下下面的例子及說(shuō)明
#pragma warning( disable : 4507 34; once : 4385; error : 164 )
等價(jià)于：
#pragma warning(disable:4507 34) // 不顯示4507和34號(hào)警告信息
#pragma warning(once:4385) // 4385號(hào)警告信息僅報(bào)告一次
#pragma warning(error:164) // 把164號(hào)警告信息作為一個(gè)錯(cuò)誤。
同時(shí)這個(gè)pragma warning 也支持如下格式：
#pragma warning( push [ ,n ] )
#pragma warning( pop )
這里n代表一個(gè)警告等級(jí)(1---4)。
#pragma warning( push )保存所有警告信息的現(xiàn)有的警告狀態(tài)。
#pragma warning( push, n)保存所有警告信息的現(xiàn)有的警告狀態(tài)，并且把全局警告
等級(jí)設(shè)定為n。
#pragma warning( pop )向棧中彈出最后一個(gè)警告信息，在入棧和出棧之間所作的
一切改動(dòng)取消。例如：
#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
#pragma warning( pop )
在這段代碼的最后，重新保存所有的警告信息(包括4705，4706和4707)
在使用標(biāo)準(zhǔn)C++進(jìn)行編程的時(shí)候經(jīng)常會(huì)得到很多的警告信息,而這些警告信息都是不必要的提示,
所以我們可以使用#pragma warning(disable:4786)來(lái)禁止該類型的警告
在vc中使用ADO的時(shí)候也會(huì)得到不必要的警告信息,這個(gè)時(shí)候我們可以通過(guò)
#pragma warning(disable:4146)來(lái)消除該類型的警告信息
六. pragma comment(...)
該指令的格式為
#pragma comment( "comment-type" [, commentstring] )
該指令將一個(gè)注釋記錄放入一個(gè)對(duì)象文件或可執(zhí)行文件中,
comment-type(注釋類型):可以指定為五種預(yù)定義的標(biāo)識(shí)符的其中一種
五種預(yù)定義的標(biāo)識(shí)符為:
compiler:將編譯器的版本號(hào)和名稱放入目標(biāo)文件中,本條注釋記錄將被編譯器忽略
如果你為該記錄類型提供了commentstring參數(shù),編譯器將會(huì)產(chǎn)生一個(gè)警告
例如:#pragma comment( compiler )
exestr:將commentstring參數(shù)放入目標(biāo)文件中,在鏈接的時(shí)候這個(gè)字符串將被放入到可執(zhí)行文件中,
當(dāng)操作系統(tǒng)加載可執(zhí)行文件的時(shí)候,該參數(shù)字符串不會(huì)被加載到內(nèi)存中.但是,該字符串可以被
dumpbin之類的程序查找出并打印出來(lái),你可以用這個(gè)標(biāo)識(shí)符將版本號(hào)碼之類的信息嵌入到可
執(zhí)行文件中!
lib:這是一個(gè)非常常用的關(guān)鍵字,用來(lái)將一個(gè)庫(kù)文件鏈接到目標(biāo)文件中
常用的lib關(guān)鍵字，可以幫我們連入一個(gè)庫(kù)文件。
例如:
#pragma comment(lib, "user32.lib")
該指令用來(lái)將user32.lib庫(kù)文件加入到本工程中
linker:將一個(gè)鏈接選項(xiàng)放入目標(biāo)文件中,你可以使用這個(gè)指令來(lái)代替由命令行傳入的或者在開(kāi)發(fā)環(huán)境中
設(shè)置的鏈接選項(xiàng),你可以指定/include選項(xiàng)來(lái)強(qiáng)制包含某個(gè)對(duì)象,例如:
#pragma comment(linker, "/include:__mySymbol")
你可以在程序中設(shè)置下列鏈接選項(xiàng)
/DEFAULTLIB
/EXPORT
/INCLUDE
/MERGE
/SECTION
這些選項(xiàng)在這里就不一一說(shuō)明了,詳細(xì)信息請(qǐng)看msdn!
user:將一般的注釋信息放入目標(biāo)文件中commentstring參數(shù)包含注釋的文本信息,這個(gè)注釋記錄將被鏈接器忽略
例如:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )
補(bǔ)充一個(gè)
#pragma pack(n)
控制對(duì)齊 如
#pragma pack(push)
#pragma pack(1)
struct s_1{
char szname[1];
int a;
};
#pragma pack(pop)
struct s_2{
char szname[1];
int a;
};
則
printf("s_1 size : %d\n", sizeof(struct s_1));
printf("s_2 size : %d\n", sizeof(struct s_2));
得到5，8。
＃pragma的用法
＃pragma是一個(gè)C語(yǔ)言中的預(yù)處理指令，它的作用是設(shè)定編譯器的狀態(tài)或者是指示編譯器完成一些特定的動(dòng)作。依據(jù)定義,編譯指示是機(jī)器或操作系統(tǒng)專有的,且對(duì)于每個(gè)編譯器都是不同的。
其格式一般為: #pragma Para
其中Para 為參數(shù)，下面來(lái)看一些常用的參數(shù)。
(1)message 參數(shù)。 Message 參數(shù)是我最喜歡的一個(gè)參數(shù)，它能夠在編譯信息輸出窗
口中輸出相應(yīng)的信息，這對(duì)于源代碼信息的控制是非常重要的。其使用方法為：
#Pragma message(“消息文本”)
當(dāng)編譯器遇到這條指令時(shí)就在編譯輸出窗口中將消息文本打印出來(lái)。
當(dāng)我們?cè)诔绦蛑卸x了許多宏來(lái)控制源代碼版本的時(shí)候，我們自己有可能都會(huì)忘記有沒(méi)有正確的設(shè)置這些宏，此時(shí)我們可以用這條指令在編譯的時(shí)候就進(jìn)行檢查。假設(shè)我們希望判斷自己有沒(méi)有在源代碼的什么地方定義了_X86這個(gè)宏可以用下面的方法
#ifdef _X86
#Pragma message(“_X86 macro activated!”)
#endif
當(dāng)我們定義了_X86這個(gè)宏以后，應(yīng)用程序在編譯時(shí)就會(huì)在編譯輸出窗口里顯示“_
X86 macro activated!”。我們就不會(huì)因?yàn)椴挥浀米约憾x的一些特定的宏而抓耳撓腮了
。
(2)另一個(gè)使用得比較多的pragma參數(shù)是code_seg。格式如：
#pragma code_seg( ["section-name"[,"section-class"] ] )
它能夠設(shè)置程序中函數(shù)代碼存放的代碼段，當(dāng)我們開(kāi)發(fā)驅(qū)動(dòng)程序的時(shí)候就會(huì)使用到它。
(3)#pragma once (比較常用）
只要在頭文件的最開(kāi)始加入這條指令就能夠保證頭文件被編譯一次，這條指令實(shí)際上在VC6中就已經(jīng)有了，但是考慮到兼容性并沒(méi)有太多的使用它。
(4)#pragma hdrstop表示預(yù)編譯頭文件到此為止，后面的頭文件不進(jìn)行預(yù)編譯。BCB可以預(yù)編譯頭文件以加快鏈接的速度，但如果所有頭文件都進(jìn)行預(yù)編譯又可能占太多磁盤空間，所以使用這個(gè)選項(xiàng)排除一些頭文件。
有時(shí)單元之間有依賴關(guān)系，比如單元A依賴單元B，所以單元B要先于單元A編譯。你可以用#pragma startup指定編譯優(yōu)先級(jí)，如果使用了#pragma package(smart_init) ，BCB就會(huì)根據(jù)優(yōu)先級(jí)的大小先后編譯。
(5)#pragma resource "*.dfm"表示把*.dfm文件中的資源加入工程。*.dfm中包括窗體
外觀的定義。
(6)#pragma warning( disable : 4507 34; once : 4385; error : 164 )
等價(jià)于：
#pragma warning(disable:4507 34) // 不顯示4507和34號(hào)警告信息
#pragma warning(once:4385) // 4385號(hào)警告信息僅報(bào)告一次
#pragma warning(error:164) // 把164號(hào)警告信息作為一個(gè)錯(cuò)誤。
同時(shí)這個(gè)pragma warning 也支持如下格式：
#pragma warning( push [ ,n ] )
#pragma warning( pop )
這里n代表一個(gè)警告等級(jí)(1---4)。
#pragma warning( push )保存所有警告信息的現(xiàn)有的警告狀態(tài)。
#pragma warning( push, n)保存所有警告信息的現(xiàn)有的警告狀態(tài)，并且把全局警告
等級(jí)設(shè)定為n。
#pragma warning( pop )向棧中彈出最后一個(gè)警告信息，在入棧和出棧之間所作的
一切改動(dòng)取消。例如：
#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
//.......
#pragma warning( pop )
在這段代碼的最后，重新保存所有的警告信息(包括4705，4706和4707)。
（7）pragma comment(...)
該指令將一個(gè)注釋記錄放入一個(gè)對(duì)象文件或可執(zhí)行文件中。
常用的lib關(guān)鍵字，可以幫我們連入一個(gè)庫(kù)文件。
（8）progma pack（n）
指定結(jié)構(gòu)體對(duì)齊方式！#pragma
pack(n)來(lái)設(shè)定變量以n字節(jié)對(duì)齊方式。n字節(jié)對(duì)齊就是說(shuō)變量存放的起始地址的偏移量有兩種情況：第一、如果n大于等于該變量所占用的字節(jié)數(shù)，那么偏
移量必須滿足默認(rèn)的對(duì)齊方式，第二、如果n小于該變量的類型所占用的字節(jié)數(shù)，那么偏移量為n的倍數(shù)，不用滿足默認(rèn)的對(duì)齊方式。結(jié)構(gòu)的總大小也有個(gè)約束條
件，分下面兩種情況：如果n大于所有成員變量類型所占用的字節(jié)數(shù)，那么結(jié)構(gòu)的總大小必須為占用空間最大的變量占用的空間數(shù)的倍數(shù)；
否則必須為n的倍數(shù)。下面舉例說(shuō)明其用法。
#pragma pack(push) //保存對(duì)齊狀態(tài)
#pragma pack(4)//設(shè)定為4字節(jié)對(duì)齊
struct test
{
char m1;
double m4;
int m3;
};
#pragma pack(pop)//恢復(fù)對(duì)齊狀態(tài)
為測(cè)試該功能，可以使用sizeof（）測(cè)試結(jié)構(gòu)體的長(zhǎng)度！