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

指令

预处理指令控制预处理器的行为。每个指令占据一行并拥有下列格式:

  • # 字符
  • 预处理指令(defineundefincludeififdefifndefelseelifendiflineerrorpragma 之一)[1]
  • 实参(取决于指令)
  • 换行符

允许空指令(后随换行符的 #),而它没有效果。


导入声明亦为预处理指令。
(C++20 起)

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

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

能力

预处理器拥有源文件翻译能力:

  • 有条件编译源文件的某些部分(由 #if#ifdef#ifndef#else#elif#endif 指令控制)。
  • 替换文本宏,同时可能对标识符进行拼接或加引号(由 #define#undef 指令与 ### 运算符控制)。
  • 包含其他文件(由 #include 指令控制并以 __has_include 检查 (C++17 起))。
  • 引发错误(由 #error 指令控制)

能控制预处理器的下列方面:

脚注

  • 这些指令是标准定义的。标准不定义其他指令的行为:它们可以被忽略、拥有一些有用的含义或导致编译时错误。即使忽略,也会在预处理器完成工作时将它们从源码中移除。一种常用的非标准扩展是 #warning 指令,它在编译期间放出一条用户定义的消息。