/E (前置處理至 stdout)

前置處理 C 和 C++ 原始程式檔，並將前置處理過的檔案複製至標準輸出裝置。

/E

備註

在這個處理序中，所有前置處理器指示詞 (Preprocessor Directive) 都會加以執行，巨集也會展開，註解則會移除。若要在前置處理過的輸出中保留註解，請同時使用 /C (前置處理時保留註解) 選項。

/E 會將 #line 指示詞加入至輸出，在每一個包含納入之檔案的開頭和結尾，以及環繞於前置處理器指示詞所移除的行，以進行條件式編譯。這些指示詞會重編經前置處理之檔案的行號，因此在處理稍後階段中產生的錯誤會參考原來的原始程式檔中的行號，而不是經前置處理過的檔案中的行。

/E 選項會隱藏編譯。您必須重新送出前置處理過的檔案，進行編譯。 /E 也會隱藏 /FA、/Fa 和 /Fm 選項的輸出檔。如需詳細資訊，請參閱 /FA、/Fa (清單檔)和 /Fm (命名對應檔)。

若要隱藏 #line 指示詞，請使用 /EP (前置處理至 stdout 不加 #line 指示詞) 選項取代。

若要將前置處理過的輸出傳送至檔案而不傳遞至 stdout，請改用 /P (前置處理至檔案) 選項。

若要隱藏 #line 指示詞，並將前置處理過的輸出傳送至檔案，請同時使用 /P 和 /EP。

您不能配合 /E 選項使用先行編譯標頭。

請注意，在前置處理一個單獨的檔案時，語彙基元 (Token) 後面不會產生空格，這樣可能會產生不合法的程式或具有不想要的副作用。下列程式會順利編譯成功：

#define m(x) x
m(int)main( )
{
   return 0;
}

但是，如果您是以下列方式編譯：

cl -E test.cpp > test2.cpp

test2.cpp 中的 int main 將會在錯誤的情況下成為 intmain。

以下命令列會前置處理 ADD.C、保留註解、加入 #line 指示詞，並且將結果顯示在標準輸出裝置上：

CL /E /C ADD.C