预处理器

預處理器在編譯前的翻譯階段 4 執行。預處理的結果是單個文件，接下來它會被傳遞給實際編譯器。

指令

預處理指令控制預處理器的行為。每個指令占據一行並擁有下列���式：

• # 字符
• 包含以下內容的序列：

• 由標準定義的指令名（見下文）後隨對應的實參，或
• 一個或多個預處理記號，其中第一個記號不是由標準定義的指令名，此時該指令受條件性支持並且語義由實現定義（例如常用的非標準擴展預處理指令 #warning 會在編譯時放出一條用戶定義的消息），或
• 什麼也不含，此時該指令沒有效果。

• 換行符

預處理指令不得來自宏展開。

#define EMPTY
EMPTY   #   include <file.h> // 不是预处理指令

能力

預處理器有能力翻譯源文件：

• 有條件編譯源文件的某些部分（由 #if、#ifdef、#ifndef、#else、#elif、#elifdef、#elifndef(C++23 起) 和 #endif 指令控制）。
• 替換文本宏，同時可能對標識符進行拼接或加引號（由 #define 和 #undef 指令與 # 和 ## 運算符控制）。
• 包含其他文件（由 #include 指令控制並以 __has_include 檢查(C++17 起)）。
• 導致錯誤或警告(C++23 起)（由指令 #error 或 #warning(C++23 起) 控制）。

能控制預處理器的下列方面：

• 由實現定義的行為（由 #pragma 指令和 _Pragma 運算符(C++11 起)控制）。
• 對預處理器可用的文件名和行信息（由 #line 指令控制）

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

參閱