在所有的預先處理指令中,#pragma 指令可能是最複雜的了,它的作用是設定編譯器的狀態或者是指示編譯器完成一些特定的動作。#pragma 指令對每個編譯器給出了一個方法,在保持與C和C++語言完全相容的情況下,給出主機或作業系統專有的特徵。依據定義,編譯指示是機器或作業系統專有的, 且對於每個編譯器都是不同的。
其格式一般為: #Pragma Para
其中Para 為參數,下面來看一些常用的參數。
(
在編寫程式的時候
,我們經常要用到#pragma指令來設定編譯器的狀態或者是指示編譯器完成一些特定的動作
.
下面介紹了一下該指令的一些常用參數
,希望對大家有所協助
!
一. message 參數。
message
它能夠在編譯資訊輸出窗
口中輸出相應的資訊,這對於原始碼資訊的控制是非常重要的。
其使用方法為: #pragma message("訊息文本")
當編譯器遇到這條指令時就在編譯輸出視窗中將訊息文本列印出來。
當我們在程式中定義了許多宏來控制原始碼版本的時候,我們自己有可能都會忘記有沒有正確的設定這些宏,此時我們可以用這條指令在編譯的時候就進行檢查。假設我們希望判斷自己有沒有在原始碼的什麼地方定義了_X86這個宏可以用下面的方法:
#ifdef _X86
#pragma message("_X86 macro activated!")
#endif
當我們定義了_X86這個宏以後,應用程式在編譯時間就會在編譯輸出視窗裡顯示
"_X86 macro activated!"
這樣,我們就不會因為不記得自己定義的一些特定的宏而抓耳撓腮了。
二. 另一個使用得比較多的#pragma參數是code_seg。
格式如:
#pragma code_seg( [ [ { push | pop}, ] [ identifier, ] ] [ "segment-name" [, "segment-class" ] )
該指令用來指定函數在.obj檔案中存放的節,觀察OBJ檔案可以使用VC內建的dumpbin命令列程式,函數在.obj檔案中預設的存放節為.text節,如果code_seg沒有帶參數的話,則函數存放在.text節中。
push (選擇性參數) 將一個記錄放到內部編譯器的堆棧中,選擇性參數可以為一個標識符或者節名
pop(選擇性參數) 將一個記錄從堆棧頂端彈出,該記錄可以為一個標識符或者節名
identifier (選擇性參數) 當使用push指令時,為壓入堆棧的記錄指派的一個標識符,當該標識符被刪除的時候和其相關的堆棧中的記錄將被彈出堆棧
"segment-name" (選擇性參數) 表示函數存放的節名
例如:
//預設情況下,函數被存放在.text節中
void func1() { // stored in .text
}
//將函數存放在.my_data1節中
#pragma code_seg(".my_data1")
void func2() { // stored in my_data1
}
//r1為標識符,將函數放入.my_data2節中
#pragma code_seg(push, r1, ".my_data2")
void func3() { // stored in my_data2
}
int main() {
}
例如
#pragma code_seg(“PAGE”)
作用是將此部分代碼放入分頁記憶體中運行。
#pragma code_seg()
將程式碼片段設定為預設的程式碼片段
#pragma code_seg("INIT")
載入到INIT記憶體地區中,成功載入後,可以退出記憶體
三. #pragma once (比較常用)
這是一個比較常用的指令,只要在標頭檔的最開始加入這條指令就能夠保證標頭檔被編譯一次
四. #pragma hdrstop表示先行編譯標頭檔到此為止,後面的標頭檔不進行先行編譯。
BCB可以先行編譯標頭檔以加快連結的速度,但如果所有標頭檔都進行先行編譯又可能占太多磁碟空間,所以使用這個選項排除一些標頭檔。
有時單元之間有依賴關係,比如單元A依賴單元B,所以單元B要先於單元A編譯。你可以用#pragma startup指定編譯優先順序,如果使用了#pragma package(smart_init) ,BCB就會根據優先順序的大小先後編譯。
五. #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 )
這裡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)
在使用標準C++進行編程的時候經常會得到很多的警告資訊,而這些警告資訊都是不必要的提示,所以我們可以使用#pragma warning(disable:4786)來禁止該類型的警告在vc中使用ADO的時候也會得到不必要的警告資訊,這個時候我們可以通過#pragma
warning(disable:4146)來消除該類型的警告資訊
六. pragma comment(...)
該指令的格式為: #pragma comment( "comment-type" [, commentstring] )
該指令將一個注釋記錄放入一個對象檔案或可執行檔中,comment-type(注釋類型):可以指定為五種預定義的標識符的其中一種。
五種預定義的標識符為:
1、compiler:將編譯器的版本號碼和名稱放入目標檔案中,本條注釋記錄將被編譯器忽略
如果你為該記錄類型提供了commentstring參數,編譯器將會產生一個警告
例如:#pragma comment( compiler )
2、exestr:將commentstring參數放入目標檔案中,在連結的時候這個字串將被放入到可執行檔中,當作業系統載入可執行檔的時候,該參數字串不會被載入到記憶體中.但是,該字串可以被dumpbin之類的程式尋找出並列印出來,你可以用這個標識符將版本號碼之類的資訊嵌入到可執行檔中!
3、lib:這是一個非常常用的關鍵字,用來將一個庫檔案連結到目標檔案中常用的lib關鍵字,可以幫我們連入一個庫檔案。
例如:
#pragma comment(lib, "user32.lib")
該指令用來將user32.lib庫檔案加入到本工程中
4、linker:將一個連結選項放入目標檔案中,你可以使用這個指令來代替由命令列傳入的或者在開發環境中設定的連結選項,你可以指定/include選項來強制包含某個對象,例如:
#pragma comment(linker, "/include:__mySymbol")
你可以在程式中設定下列連結選項
/DEFAULTLIB
/EXPORT
/INCLUDE
/MERGE
/SECTION
這些選項在這裡就不一一說明了,詳細資料請看msdn!
5、user:將一般的注釋資訊放入目標檔案中commentstring參數包含注釋的文本資訊,這個注釋記錄將被連結器忽略
例如:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )