预处理器

预处理器在翻译阶段 4，编译之前执行。预处理的结果是单个文件，然后将其传递给实际的编译器。

一个标准定义的指令名称（列于下方），后跟相应的参数，或
一个或多个预处理记号，其中起始记号不是标准定义的指令名称，在这种情况下，指令是有条件支持的，具有实现定义的语义 (例如，常见的非标准扩展是 #warning 指令，它在编译期间发出用户定义的消息)(截至 C++23)，或
什么都没有，在这种情况下，指令不起作用。

(C++20 起)

预处理指令不得来自宏展开。

#define EMPTY
EMPTY   #   include <file.h> // not a preprocessing directive

预处理器具有源文件翻译功能：

有条件地 编译源文件的部分内容（由指令 #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 起) 控制）。此外，一些编译器（在不同程度上）支持运算符 __pragma 作为非标准扩展。
可供预处理器使用的文件名和行信息（由指令 #line 控制）。

以下行为变更缺陷报告被追溯应用到先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
CWG 2001	C++98	使用非标准定义指令的行为不明确	变为有条件支持

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C++23 起)(C++23 起)
#define#undef#,## 运算符
#include__has_include (C++17 起)
#error#warning (C++23 起)
#pragma_Pragma (C++11 起)
#line
#embed (C++26)

目录