Linux之#pragma的用法

先行編譯指令#pragma的用法

最近在看開源項目中的代碼時，發現許多地方都用到了#pragma的程式。因此，就問了下Google老師，總結了下＃pragma先行編譯指令的常用用法，現在和大家分享下。

一.#pragma最常用的方法1. #progma pack（n）1>功能：

使用#progma pack先行編譯指令可以改變編譯器的預設值（不是絕對的，有些編譯器只能是固定的資料對齊）。

2>說明

大多數情況下，我們寫程式時候並不考慮對齊的問題，因為編譯器會替我們選擇對的策略。大多數編譯器都是預設四位元組對齊。

大家可以看一個程式就明白了：

程式A:

#include<stdio.h>

struct  A

{

    int       a;

    char     b;

    short    c;   

};

int  main()

{

    int d;

    d=  sizeof (struct A);

    printf(“theleng=%d\n”,d);

     return 0;

}

註：

(1)一般現在我們用的都是32位的處理器，vc編譯器預設的對齊位元組數目是4位元組。在gcc下預設為以結構體中最大類型的變數為位元組對齊。

結構體A中包含了4位元組長度的int一個，1位元組長度的char一個和2位元組長度的short型資料一個。所以A用到的空間應該是7位元組。但是因為編譯器要對資料成員在空間上進行對齊。所以使用sizeof(strcut A)值為8《a 佔4個位元組，b佔一個位元組，c佔兩個位元組，因此編譯器會把b和C放在一個4位元組之內，因此結構體A佔8個位元組》

(2)現在我們討論下位元組對齊的好處：

現代電腦中記憶體空間都是按照byte劃分的，從理論上講似乎對任何類型的變數的訪問可以從任何地址開始，但實際情況是在訪問特定變數的時候經常在特定的記憶體位址訪問，這就需要各類型資料按照一定的規則在空間上排列，而不是順序的一個接一個的排放，這就是對齊

 

對齊的作用和原因：各個硬體平台對儲存空間的處理上有很大的不同。一些平台對某些特定類型的資料只能從某些特定地址開始存取。其他平台可能沒有這種情況，但是最常見的是如果不按照適合其平台要求對資料存放進行對齊，會在存取效率上帶來損失

 

比如有些平台每次讀都是從偶地址開始，如果一個int型（假設為32位系統）如果存放在偶地址開始的地方，那麼一個讀周期就可以讀出，而如果存放在奇地址開始的地方，就可能會需要2個讀周期，並對兩次讀出的結果的高低位元組進行拼湊才能得到該int資料。顯然在讀取效率上下降很多。這也是空間和時間的博弈

3>How to Use?

使用方法舉例：
#pragma  pack(push)  //儲存以前的對齊狀態，push是將以前的對齊狀態壓入棧  
#pragma  pack(1)  //指定新的對齊狀態，1個位元組
//定義你的結構  
//…………  
#pragma  pack(pop)  //彈出棧，恢複以前的對齊狀態

現在我們把剛才的程式修改下：

程式B:

#include<stdio.h>

 

#pragma   pack(push)

#pragma   pack(1)

 

struct  A

{

    int       a;

    char     b;

    short     c;   

};

#pragma     pack(pop);

int  main()

{

    int  d;

    d =  sizeof (struct A);

    printf(“theleng=%d\n”,d);

     return 0;

}

此時因為是按一位元組對齊，因此結構體A總共佔用7個位元組。

2. #pragma  message(“字串常量”)

1>功能：

當編譯器遇到這條指令時就在編譯輸出視窗中將訊息文本列印出來

2>說明：

當我們在程式中定義了許多宏來控制原始碼版本的時候，我們自己有可能都會忘記有沒有正確的設定這些宏，此時我們可以用這條指令在編譯的時候就進行檢查。

3>How  to  use?
#pragma message(“macro activated!”)

註：此處在message()後不加分號。

3.#pragma  once

1>功能：

只要在標頭檔的最開始加入這條指令就能夠保證標頭檔被編譯一次

2>說明：#pragma  once與#ifndef的區別

（1）相同點：

為了避免同一個檔案被include多次，#ifndef方式和#pragma  once方式（前提是編譯器能同時支援兩種方式的編譯器上），兩者並沒有多太大的區別。

（2）兩者的使用方法：

方法一：

#ifndef  __TIGER_H__

#define  __TIGER_H__

……….//一些聲明語句

#endif

方法二：

#pragma   once

………//一些聲明語句

（3）兩者的區別：

#ifndef  的方式依賴於宏名不能衝突，這不光可以保證同一個檔案不會被包含多次，也能保證內容完全相同的兩個標頭檔不會被不小心同時包含。當然，缺點就是如果不同標頭檔的宏名不小心“撞車”，可能就會導致標頭檔明明存在，編譯器卻硬說找不到聲明的狀況。

#pragma  once則由編譯器提供保證：同一個檔案不會被包含多次。注意此處說的同一個檔案是指物理上的一個檔案，而不是指內容相同的兩個檔案。帶來的好處就是；你不必再費勁想個宏名了，當然也就不會出現宏名碰撞引發的奇怪問題。對應的缺點就是如果某個標頭檔有多份拷貝，本方法不能保證他們不被重複包含。當然，相比宏名碰撞引發的“找不到聲明”的問題，重複包含更容易被發現並修正。

對於#pragmaonce,根據MSDN解說，能夠防止一個檔案被多次包含。與#ifndef #define #endif形式的檔案保護相比，前者是平台相關的，可移植性比較差，但是它效率更高，因為它不需要去開啟包含的檔案，就可以判斷這個檔案有沒有被包含。當然這個工作是系統幫我們完成的。後者的優點在於它是語言相關的特性，所以可移植性好。但是在包含一個檔案的時候，只有開啟這個檔案，根據檔案的保護宏是否已經被定義來判斷此檔案是否已經被包含過。效率相對較低。當然在＃include的時候，程式員也可以自己判斷所要包含的檔案的保護宏是否已經被定義，來決定是否要包含這個檔案。類似下面的代碼：

#ifndef FILE_H_

＃include "file.h"

#endif

這樣作可以得到較高的效率，而且保證可移植性。但是檔案之間的依賴性較高，如果一個檔案的保護宏改變的話，所有使用如上形式包含這個檔案的檔案都要修改。有悖於模組化的思想。

二.#pragma的一些其他方法1.#pragma參數是code_seg。

1>格式： 

#pragma code_seg( [ [ { push | pop}, ] [ identifier, ]] [ "segment-name" [, "segment-class" ] )

2>功能：

它能夠設定程式中函數代碼存放的程式碼片段，當我們開發驅動程式的時候就會使用到它

3>說明：

該指令用來指定函數在.obj檔案中存放的節,觀察OBJ檔案可以使用VC內建的dumpbin命令列程式,函數在.obj檔案中預設的存放節為.text節 ，如果code_seg沒有帶參數的話,則函數存放在.text節中 。push(選擇性參數) 將一個記錄放到內部編譯器的堆棧中,選擇性參數可以為一個標識符或者節名。pop(選擇性參數) 將一個記錄從堆棧頂端彈出,該記錄可以為一個標識符或者節名 。identifier (選擇性參數) 當使用push指令時,為壓入堆棧的記錄指派的一個標識符,當該標識符被刪除的時候和其相關的堆棧中的記錄將被彈出堆棧 。"segment-name"(選擇性參數) 表示函數存放的節名

3>執行個體：

//預設情況下,函數被存放在.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() {

}

2.#pragma hdrstop

1>功能：

表示先行編譯標頭檔到此為止，後面的標頭檔不進行先行編譯，BCB可以先行編譯標頭檔以加快連結的速度，但如果所有標頭檔都進行先行編譯又可能占太多磁碟空間，所以使用這個選項排除一些標頭檔。 

有時單元之間有依賴關係，比如單元A依賴單元B，所以單元B要先於單元A編譯。你可以用#pragma startup指定編譯優先順序，如果使用了#pragma package(smart_init) ，BCB就會根據優先順序的大小先後編譯。 
3. #pragma warning

1>功能：

該指令允許有選擇性的修改編譯器的警告訊息的行為

2>指令格式：

#pragma warning( warning-specifier :warning-number-list [; warning-specifier : warning-number-list...]

#pragma warning( push[ ,n ] )

#pragma warning( pop )

3>主要用到的警告表示有如下幾個:

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)來消除該類型的警告資訊

4.# pragma comment(...)

1>功能：

該指令將一個注釋記錄放入一個對象檔案或可執行檔中。

2>格式：

#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庫檔案加入到本工程中

linker:將一個連結選項放入目標檔案中,你可以使用這個指令來代替由命令列傳入的或者在開發環境中

       設定的連結選項,你可以指定/include選項來強制包含某個對象,例如:

      #pragma comment(linker, "/include:__mySymbol")

你可以在程式中設定下列連結選項

/DEFAULTLIB

/EXPORT

/INCLUDE

/MERGE

/SECTION

這些選項在這裡就不一一說明了,詳細資料請看msdn!

5.#pragma resource"*.dfm"

1>功能：

表示把*.dfm檔案中的資源加入工程。*.dfm中包括表單外觀的定義。