C 語言預處理命令總結大全

C程式的原始碼中可包括各種編譯指令，這些指令稱為預處理命令。雖然它們實際上不是C語言的一部分，但卻擴充套件了C程式設計的環境。本節將介紹如何應用預處理程式和註釋簡化程式開發過程，並提高程式的可讀性。ANSI標準定義的C語言預處理程式包括下列命令：

#define，#error，＃include，#if，#else，#elif，#endif，#ifdef，#ifndef，#undef，#line，#pragma等。

非常明顯，所有預處理命令均以符號#開頭，下面分別加以介紹。

一 #define

命令#define定義了一個識別符號及一個串。在源程式中每次遇到該識別符號時，均以定義的串代換它。ANSI標準將識別符號定義為巨集名，將替換過程稱為巨集替換。命令的一般形式為：

#define identifier string

注意：

1該語句沒有分號。在識別符號和串之間可以有任意個空格，串一旦開始，僅由一新行結束。

2巨集名定義後，即可成為其它巨集名定義中的一部分。

3 巨集替換僅僅是以文字串代替巨集識別符號，前提是巨集識別符號必須獨立的識別出來，否則不進行替換。例如：

#define XYZ this is a tes

使用巨集printf(“XYZ”)；//該段不列印”this is a test”而列印”XYZ”。因為預編譯器識別出的是”XYZ”

4如果串長於一行，可以在該行末尾用一反斜槓’ \’續行。

#defineLONG_STRING"this is a very long\
string that is used as an example"

5 C語言程式普遍使用大寫字母定義識別符號。

6 用巨集代換代替實在的函式的一大好處是巨集替換增加了程式碼的速度，因為不存在函式呼叫的開銷。但增加速度也有代價：由於重複編碼而增加了程式長度。

二 #error

命令#error強迫編譯程式停止編譯，主要用於程式除錯。

#error指令使前處理器發出一條錯誤訊息，該訊息包含指令中的文字.這條指令的目的就是在程式崩潰之前能夠給出一定的資訊。

三 #include

命令＃i nclude使編譯程式將另一原始檔嵌入帶有＃include的原始檔，被讀入的原始檔必須用雙引號或尖括號括起來。例如：

#include”stdio.h”或者＃include

這兩行程式碼均使用C編譯程式讀入並編譯用於處理磁碟檔案庫的子程式。

將檔案嵌入#i nclude命令中的檔案內是可行的，這種方式稱為巢狀的嵌入檔案，巢狀層次依賴於具體實現。

如果顯式路徑名為檔案識別符號的一部分，則僅在那些子目錄中搜尋被嵌入檔案。否則，如果檔名用雙引號括起來，則首先檢索當前工作目錄。如果未發現檔案，則在命令列中說明的所有目錄中搜尋。如果仍未發現檔案，則搜尋實現時定義的標準目錄。

如果沒有顯式路徑名且檔名被尖括號括起來，則首先在編譯命令列中的目錄內檢索。如果檔案沒找到，則檢索標準目錄，不檢索當前工作目錄。

四 條件編譯命令

有幾個命令可對程式原始碼的各部分有選擇地進行編譯，該過程稱為條件編譯。商業軟體公司廣泛應用條件編譯來提供和維護某一程式的許多顧客版本。

#if、#else，#elif及#endif

#if的一般含義是如果#if後面的常量表示式為true，則編譯它與#endif之間的程式碼，否則跳過這些程式碼。命令#endif標識一個#if塊的結束。

#if constant-expression
statement sequence
#endif

Eg:

#define MAX 91
#include 
using namespace std;
int main()
{
#if MAX > 99
       cout<<"MAX is bigger than 99"<
#elif MAX > 90
       cout<<"MAX is bigger than 90"<
#else
       cout<<"MAX is smaller than 90"<
#endif
       return 0;
}

跟在#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。

#define MAX 91
#include 
using namespace std;

int main()
{
#ifdef MAX
       cout<<"hello,MAX!"<
#else
       cout<<"where is MAX?"<
#endif
#ifndef LEO
       cout<<"LEO is not defined"<
#endif
       return 0;
}

命令#undef 取消其後那個前面已定義過有巨集名定義。一般形式為：

#undef macroname

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

#line number["filename"]

其中的數字為任何正整數，可選的檔名為任意有效檔案識別符號。行號為源程式中當前行號，檔名為原始檔的名字。命令#line主要用於除錯及其它特殊應用。注意：在#line後面的數字標識從下一行開始的數字標識。

#line 100 "jia"
       cout<<"#line change line and filename!"<
       cout<<__LINE__<
       cout<<__FILE__<

五 #pragma

命令#pragma 為實現時定義的命令，它允許向編譯程式傳送各種指令。

#pragma的作用是設定編譯器的狀態或者是指示編譯器完成一些特定的動作。#pragma指令對每個編譯器給出了一個方法,在保持與C和C++語言完全相容的情況下,給出主機或作業系統專有的特徵。依據定義,編譯指示是機器或作業系統專有的,且對於每個編譯器都是不同的。
其格式一般為: #Pragma Para

1 message 引數。

Message 引數能夠在編譯資訊輸出視窗中輸出相應的資訊，這對於原始碼資訊的控制是非常重要的。其使用方法為：
#pragma message(“訊息文字”)

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

當我們在程式中定義了許多巨集來控制原始碼版本的時候，我們自己有可能都會忘記有沒有正確的設定這些巨集，此時我們可以用這條指令在編譯的時候就進行檢查。假設我們希望判斷自己有沒有在原始碼的什麼地方定義了_X86這個巨集可以用下面的方法

#ifdef _X86
#pragma message(“_X86 macro activated!”)
#endif

當我們定義了_X86這個巨集以後，應用程式在編譯時就會在編譯輸出視窗裡顯示“_
X86 macro activated!”。我們就不會因為不記得自己定義的一些特定的巨集而抓耳撓腮了。

2 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 位元組對齊就是說變數存放的起始地址的偏移量有兩種情況：

第一、如果n大於等於該變數所佔用的位元組數，那麼偏移量必須滿足預設的對齊方式，

第二、如果n小於該變數的型別所佔用的位元組數，那麼偏移量為n的倍數，不用滿足預設的對齊方式。

結構的總大小也有個約束條件，分下面兩種情況：如果n大於所有成員變數型別所佔用的位元組數，那麼結構的總大小必須為佔用空間最大的變數佔用的空間數的倍數； 否則必須為n的倍數。

下面舉例說明其用法。

#pragma pack(push) //儲存對齊狀態
#pragma pack(4)//設定為4位元組對齊
struct test
{
char m1;
double m4;
int m3;
};
#pragma pack(pop)//恢復對齊狀態

為測試該功能，可以使用sizeof（）測試結構體的長度！