編譯器各類宏使用總結

轉：

C/C++中宏總結C程序的源代碼中可包括各類編譯指令，這些指令稱爲預處理命令。雖然它們實際上不是C語言的一部分，但卻擴展了C程序設計的環境。本節將介紹如何應用預處理程序和註釋簡化程序開發過程，並提升程序的可讀性。ANSI標準定義的C語言預處理程序包括下列命令：

 

#define，#error，＃include，#if，#else，#elif，#endif，#ifdef，#ifndef，#undef，#line，#pragma等。很是明顯，全部預處理命令均以符號#開頭，下面分別加以介紹。

 

命令#define定義了一個標識符及一個串。在源程序中每次遇到該標識符時，均以定義的串代換它。ANSI標準將標識符定義爲宏名，將替換過程稱爲宏替換。命令的通常形式爲：

 

#define identifier string

 

注意：

? 該語句沒有分號。在標識符和串之間能夠有任意個空格，串一旦開始，僅由一新行結束。

? 宏名定義後，便可成爲其它宏名定義中的一部分。

? 宏替換僅僅是以文本串代替宏標識符，前提是宏標識符必須獨立的識別出來，不然不進行替換。例如：

#define XYZ this is a tes

使用宏printf("XYZ")；//該段不打印"this is a test"而打印"XYZ"。由於預編譯器識別出的是"XYZ"

? 若是串長於一行，能夠在該行末尾用一反斜槓' \'續行。

 

處理器命令#error強迫編譯程序中止編譯，主要用於程序調試。

 

#include 命令＃i nclude使編譯程序將另外一源文件嵌入帶有＃i nclude的源文件，被讀入的源文件必須用雙引號或尖括號括起來。例如：

 

＃i nclude"stdio.h"或者＃i nclude

 

這兩行代碼均使用C編譯程序讀入並編譯用於處理磁盤文件庫的子程序。

將文件嵌入＃i nclude命令中的文件內是可行的，這種方式稱爲嵌套的嵌入文件，嵌套層次依賴於具體實現。

 

若是顯式路徑名爲文件標識符的一部分，則僅在哪些子目錄中搜索被嵌入文件。不然，若是文件名用雙引號括起來，則首先檢索當前工做目錄。若是未發現文件，則在命令行中說明的全部目錄中搜索。若是仍未發現文件，則搜索實現時定義的標準目錄。

 

若是沒有顯式路徑名且文件名被尖括號括起來，則首先在編譯命令行中的目錄內檢索。

 

若是文件沒找到，則檢索標準目錄，不檢索當前工做目錄。

 

條件編譯命令

有幾個命令可對程序源代碼的各部分有選擇地進行編譯，該過程稱爲條件編譯。商業軟件公司普遍應用條件編譯來提供和維護某一程序的許多顧客版本。

 

#if、#else，#elif及#endif

 

#if的通常含義是若是#if後面的常量表達式爲true，則編譯它與#endif之間的代碼，不然跳過這些代碼。命令#endif標識一個#if塊的結束。

 

#if constant-expression

statement sequence

#endif

 

跟在#if後面的表達式在編譯時求值，所以它必須僅含常量及已定義過的標識符，不可以使用變量。表達式不準含有操做符sizeof（sizeof也是編譯時求值）。

 

#else命令的功能有點象C語言中的else；#else創建另外一選擇（在#if失敗的狀況下）。注意，# else屬於# if塊。

 

#elif命令意義與ELSE IF 相同，它造成一個if else-if階梯狀語句，可進行多種編譯選擇。#elif 後跟一個常量表達式。若是表達式爲true，則編譯其後的代碼塊，不對其它#elif表達式進行測試。不然，順序測試下一塊。

 

#if expression

statement sequence

#elif expression1

statement sequence

#endif

 

在嵌套的條件編譯中#endif、#else或#elif與最近#if或#elif匹配。

 

# ifdef 和# ifndef

 

條件編譯的另外一種方法是用#ifdef與#ifndef命令，它們分別表示"若是有定義"及"若是無定義"。# ifdef的通常形式是：

 

# ifdef macroname

statement sequence

#endif

 

#ifdef與#ifndef能夠用於#if、#else，#elif語句中，但必須與一個#endif。

 

命令#undef 取消其後那個前面已定義過有宏名定義。通常形式爲：

#undef macroname

 

命令# line改變__LINE__與__FILE__的內容，它們是在編譯程序中預先定義的標識符。命令的基本形式以下：

 

# line number["filename"]

 

其中的數字爲任何正整數，可選的文件名爲任意有效文件標識符。行號爲源程序中當前行號，文件名爲源文件的名字。命令# line主要用於調試及其它特殊應用。注意：在#line後面的數字標識從下一行開始的數字標識。

 

預約義的宏名

 

ANSI標準說明了C中的五個預約義的宏名。它們是：

 

__LINE__

__FILE__

__DATE__

__TIME__

__STDC__

 

若是編譯不是標準的，則可能僅支持以上宏名中的幾個，或根本不支持。記住編譯程序也許還提供其它預約義的宏名。

 

__LINE__及__FILE__宏指令在有關# line的部分中已討論，這裏討論其他的宏名。

__DATE__宏指令含有形式爲月/日/年的串，表示源文件被翻譯到代碼時的日期。

源代碼翻譯到目標代碼的時間做爲串包含在__TIME__中。串形式爲時：分：秒。

若是實現是標準的，則宏__STDC__含有十進制常量1。若是它含有任何其它數，則實現是非標準的。編譯C++程序時，編譯器自動定義了一個預處理名字__cplusplus，而編譯標準C時，自動定義名字__STDC__。

 

 

2、#line和#error
#line用於重置由__LINE__和__FILE__宏指定的行號和文件名。
用法以下：#line number filename
例如：#line 1000 //將當前行號設置爲1000
     #line 1000 "lukas.c"   //行號設置爲1000,文件名設置爲lukas.c

#error指令使預處理器發出一條錯誤消息，該消息包含指令中的文本.這條指令的目的就是在程序崩潰以前可以給出必定的信息。

3、#pragma
在全部的預處理指令中，#Pragma 指令多是最複雜的了。#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號警告信息。若是編譯時老是出現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）progma pack（n）
    指定結構體對齊方式！#pragma pack(n)來設定變量以n字節對齊方式。n 字節對齊就是說變量存放的起始地址的偏移量有兩種狀況：第1、若是n大於等於該變量所佔用的字節數，那麼偏移量必須知足默認的對齊方式，第2、若是n小於該變量的類型所佔用的字節數，那麼偏移量爲n的倍數，不用知足默認的對齊方式。結構的總大小也有個約束條件，分下面兩種狀況：若是n大於全部成員變量類型所佔用的字節數，那麼結構的總大小必須爲佔用空間最大的變量佔用的空間數的倍數； 不然必須爲n的倍數。下面舉例說明其用法。

#pragma pack(push) //保存對齊狀態
#pragma pack(4)//設定爲4字節對齊
struct test
{
char m1;
double m4;
int m3;
};
#pragma pack(pop)//恢復對齊狀態
爲測試該功能，可使用sizeof（）測試結構體的長度！

 

 

 

 

 

在你寫dll的時候,由於對於C和C++,編譯器會有不一樣的名字解析規則,因此能夠這樣用

#ifndef   __STDC__

extern "C "   void   function();

#else

void   function();

#endif

 

 __LINE__           在源代碼中插入當前源代碼行號
  __FILE__           在源代碼中插入當前源代碼文件名
  __DATE__           在源代碼中插入當前編譯日期〔注意和當前系統日期區別開來〕
  __TIME__           在源代碼中插入當前編譯時間〔注意和當前系統時間區別開來〕  
  __STDC__           當要求程序嚴格遵循ANSIC標準時該標識符被賦值爲1。
----------------------------------------------------------------------------

標識符__LINE__和__FILE__一般用來調試程序；標識符__DATE__和__TIME__一般用來在編譯後的程序中加入一個時間標誌，以區分程序的不一樣版本；當要求程序嚴格遵循ANSIC標準時，標識符__STDC__就會被賦值爲1；當用C++編譯程序編譯時，標識符__cplusplus就會被定義。

#include

 

int main ()

{

    printf("該輸出行在源程序中的位置：%d\n", __LINE__ );

    printf("該程序的文件名爲：%s\n", __FILE__ );

    printf("當前日期爲：%s\n", __DATE__ );

    printf("當前時間爲：%s\n", __TIME__ );

 

    return 0;

}