編譯C/C++源代碼時(shí)，源代碼首先會(huì)被預(yù)處理器（preprocessor）進(jìn)行預(yù)處理（preprocess）。
預(yù)處理器執(zhí)行源代碼中的預(yù)處理指令，如：
——文件包含
#include
——條件編譯
#if、 #ifdef、 #ifndef、 #elif、 #else、 #endif
——宏
#define、 #undef、宏標(biāo)識(shí)符、宏擴(kuò)展
——其他
#error、#line、#pragma
……
預(yù)處理之后的結(jié)果（即將提交給編譯器）與程序員看到的源代碼也許會(huì)有很大的差異。
尤其在源代碼中含有許多錯(cuò)綜復(fù)雜的宏與條件編譯時(shí)。
當(dāng)我們被這些狂亂的宏與條件編譯折磨的時(shí)候， 如果能看到預(yù)處理的結(jié)果， 也許會(huì)有很大的幫助。
下面將以一個(gè)示例說(shuō)明msvc與gcc中得到預(yù)處理結(jié)果的方式。
零、 示例
假設(shè)我們需要查看
_MSC_VER 與
__GUNC__ 兩個(gè)宏最終被擴(kuò)展出的文本：
int main() {
int result =
#if defined(__GNUC__)
__GNUC__
#elif defined(_MSC_VER)
_MSC_VER
#else
#error unknown compiler
#endif
;
return result;
}
該程序很簡(jiǎn)單， main函數(shù)返回一個(gè)result，然后立即退出。
而result的值， 根據(jù)條件編譯得到：
1. 如果是GCC編譯器， 那么result賦值為_(kāi)_GNUC__
2. 否則如果是VC編譯器， 那么result賦值為_(kāi)MSC_VER
3. 否則是一個(gè)未知的編譯器， 錯(cuò)誤
接下來(lái)， 我們來(lái)看看_MSC_VER與__GNUC__這2個(gè)宏最終到底被擴(kuò)展為什么文本。
一、 GCC
一.1、 -E 選項(xiàng)
-E選項(xiàng)將把預(yù)處理的結(jié)果，寫(xiě)入stdout。
也就是說(shuō)， 執(zhí)行如下命令：
gcc
-E preporcess_only.c
就能在控制臺(tái)中得到預(yù)處理后的
結(jié)果，大致如下：
# 1 "../preprocess_only.c"
# 1 "<built-in>"
# 1 "<command line>"
# 1 "../preprocess_only.c"
int main() {
int result =
3
;
return result;
}
可以看到， __GUNC__ 宏最終被擴(kuò)展為整數(shù)字面量3（GCC 3）。
如果源代碼很長(zhǎng)， 輸出到命令行窗口中查看也許不方便。
如何將其輸出到一個(gè)文件中呢？
一.1.1、 重定向
因?yàn)?E是輸出到stdout， 顯然可以將其重定向到另一個(gè)文件， 如執(zhí)行如下命令：
gcc -E preprocess_only.c >stdout.txt
那么stdout.txt中， 就能得到剛才命令行窗口中的內(nèi)容。
一.1.2、 -o （小寫(xiě)） 選項(xiàng)
-o選項(xiàng)用于指定出文件名。
對(duì)于-c， -o指定的是目標(biāo)文件名。
對(duì)于-S ，-o指定的是匯編文件名。
對(duì)于-E， -o自然也可以指定預(yù)處理文件名， 如執(zhí)行如下命令：
gcc -E preprocess_only.c -o output.txt
那么output.txt中會(huì)得到“一.1.1”中的stdout.txt和“一.1”中控制臺(tái)窗口一樣的結(jié)果。
一.2、-save-temps 選項(xiàng)
-save-temps選項(xiàng)將保留中間文件：如預(yù)處理后的結(jié)果文件、匯編代碼文件與目標(biāo)文件。
其中的預(yù)處理結(jié)果文件（通常有.i后綴）是我們所需要的。
舉例：
1、 gcc -save-temps -E preprocess_only.c
0個(gè)中間文件。
輸出預(yù)處理結(jié)果， 同“一.1”一樣， 輸出到控制臺(tái)窗口中。
對(duì)比如下命令：
1.1、 gcc -save-temps -E preprocess_only.c -o temp_output.txt
1.2、 gcc -save-temps -E preprocess_only.c >temp_output.txt
可以看出， -E選項(xiàng)不產(chǎn)生中間文件。 預(yù)處理結(jié)果就是最終結(jié)果。
同時(shí)可以使用 -o選項(xiàng)或者重定向， 把結(jié)果保存到一個(gè)文件中。
2、 gcc -save-temps -S preprocess_only.c
1個(gè)中間文件： preprocess_only.i（預(yù)處理結(jié)果）
1個(gè)輸出文件：preprocess_only.s（匯編代碼）
對(duì)比如下命令：
2.1、 gcc -save-temps -S preprocess_only.c -o unknown
得到preprocess_only.i文件，內(nèi)容是預(yù)處理結(jié)果，是中間文件。
得到unknown文件，內(nèi)容是匯編代碼， 是最終結(jié)果文件。
3、 gcc -save-temps -c preprocess_only.c
2個(gè)中間文件： preprocess_only.i與preprocess_only.s。
1個(gè)輸出文件： preprocess_only.o（目標(biāo)代碼）
對(duì)比如下命令：
3.1、 gcc -save-temps -c preprocess_only.c -o unknown
得到preprocess_only.i 與 preprocess_only.s文件，內(nèi)容分別是預(yù)處理結(jié)果與匯編代碼，是中間結(jié)果。
unknown文件， 內(nèi)容是目標(biāo)代碼，是最終結(jié)果文件。
4、 gcc -save-temps preprocess_only.c
3個(gè)中間文件： preprocess_only.i、preprocess_only.s、preprocess_only.o。
1個(gè)輸出文件： a.out（a.exe with mingw）。
對(duì)比如下命令：
4.1、 gcc -save-temps preprocess_only.c -o what
得到上述3個(gè)文件， 是中間文件。
what文件（what.exe with mingw）， 內(nèi)容是可執(zhí)行代碼， 是最終結(jié)果文件。
二、 MSVC
VC6、8、9中與查看預(yù)處理相關(guān)的選項(xiàng)可以通過(guò)如下命令查看：
cl /help
在輸出中， 找 -PREPROCESSOR- 這個(gè)類(lèi)別。
其中與預(yù)處理結(jié)果相關(guān)的有如下一些選項(xiàng)：
二.1、/E 選項(xiàng)
/E preprocess to stdout
/E 將預(yù)處理定向到 stdout
顯然， 這和“一.1”是等價(jià)的， 如：
cl /E preprocess_only.c
在命令行窗口中將得到類(lèi)似
結(jié)果：
#line 1 "preprocess_only.c"
int main() {
int result =
#line 6 "preprocess_only.c"
1200
#line 10 "preprocess_only.c"
;
return result;
}
可以看到， _MSC_VER宏最終被擴(kuò)展為整數(shù)字面值1200（VC6）。
對(duì)于較長(zhǎng)的源文件， 我們同樣希望將結(jié)果輸出到一個(gè)文件中。
二.1.1、重定向
執(zhí)行：
cl /E preprocess_only.c >stdout.txt
stdout.txt將保存上面的結(jié)果。
注意： 在msvc中，沒(méi)有“一.1.2”的對(duì)應(yīng)物。
執(zhí)行：
cl /help
在輸出中找到-OUTPUT FILES-類(lèi)別， 可以看到?jīng)]有命名預(yù)處理結(jié)果的方式。有兩個(gè)相似的選項(xiàng)：
/Fe 命名可執(zhí)行文件。
/Fp 命名預(yù)編譯頭文件。
但不是我們需要的選項(xiàng)。
也許VC認(rèn)為通過(guò) “/E + 重定向”就可以達(dá)到命名輸出文件的目的。
所以就沒(méi)有設(shè)計(jì)達(dá)到此目的的另一種方法。
二.2、/P 選項(xiàng)
/P preprocess to file
/P 預(yù)處理到文件
執(zhí)行：
cl /P preprocess_only.c
將得到 preprocess_only.i
/P會(huì)將對(duì) xxx.suffix 的預(yù)處理結(jié)果輸出到 xxx.i 文件中。
沒(méi)有指定文件名的方式。 如果需要指定輸出文件名， 可以使用 “/E + 重定向”
二.3 /EP 選項(xiàng)
/E與/P選項(xiàng)都將保留一部分（源文件）行信息，如“二.1”所示。
如果這是不需要的， 可以使用 /EP選項(xiàng)。
/EP preprocess to stdout, no #line
/EP 預(yù)處理到標(biāo)準(zhǔn)輸出，沒(méi)有 #line
如：
cl /EP preprocess_only.c
將得到如下輸出：
int main() {
int result =
1200
;
return result;
}
同樣， 如果需要輸出到指定文件， 可以使用重定向。
二.4 其他一些有趣的選項(xiàng)
1. /C （大寫(xiě)）
don't strip comments（不抽出注釋?zhuān)?br>如果保留注釋對(duì)理解預(yù)處理結(jié)果有幫助， 可以使用這個(gè)選項(xiàng)。
2. /U /u
/u remove all predefined macros
/u 移除所有預(yù)定義的宏
/U<name> remove predefined macro
/U<name> 移除預(yù)定義的宏
比如可以通過(guò)：
cl /u preprocess_only.c
cl /U_MSC_VER preprocess_only.c
來(lái)得到一個(gè) unknown complier錯(cuò)誤囧……
3. /D
/D<name>{=|#}<text> define macro
/D<name>{=|#}<text> 定義宏
可以通過(guò)：
cl /D__GUNC__=3 preprocess_only.c
來(lái)假裝gcc編譯器囧……
相關(guān)鏈接：
——示例文件下載
http://immature.googlecode.com/svn/trunk/iMmature/sample/compiler_options/preprocess_only/
http://www.shnenglu.com/Files/ownwaterloo/preprocess_only.zip
——《配置msvc命令行環(huán)境》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/15/environment_for_using_cl_from_command_line.html
——《配置msvc命令行環(huán)境(續(xù))——編寫(xiě)msvc編譯腳本》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/16/write_compile_script_for_msvc.html
——《預(yù)定義_MSC_VER宏》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/15/predefined_macro__MSC_VER.html
——《預(yù)定義__GNUC__宏》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/16/predefined_macro___GNUC__.html
本作品采用知識(shí)共享署名-非商業(yè)性使用-相同方式共享 2.5 中國(guó)大陸許可協(xié)議進(jìn)行許可。
轉(zhuǎn)載請(qǐng)注明 ：
文章作者 - OwnWaterloo
發(fā)表時(shí)間 - 2009年04月16日
原文鏈接 - http://www.shnenglu.com/ownwaterloo/archive/2009/04/16/preprocess_only.html
posted on 2009-04-16 00:49
OwnWaterloo 閱讀(13385)
評(píng)論(4) 編輯 收藏 引用