预处理器支持有条件地编译源文件的某些部分。这一行为由 #if、#else、#elif、#ifdef、#ifndef 与 #endif 指令所控制。

语法

解释

条件编译预处理块由 #if、#ifdef 或 #ifndef 指令开始，并可选地包含任意多个 #elif 指令，接下来是至多一个可选的 #else 指令，并以 #endif 指令结束。嵌套的条件编译预处理块会被单独处理。

各个 #if、#elif、#else、#ifdef 和 #ifndef 指令所控制的代码块在第一个不属于内部嵌套的条件编译预处理块的 #elif、#else 或 #endif 指令处结束。

#if、#ifdef 和 #ifndef 指令测试其所指定的条件（见下文），如果条件求值为真，则编译其控制的代码块。此时后续的 #else 和 #elif 指令将被忽略。否则，如果所指定的条件求值为假，则将跳过其所控制的代码块，然后处理后续的 #else 或 #elif 指令（如果存在）。前一种情况下，#else 指令所控制的代码块将会无条件地进行编译。后一种情况下，#elif 指令按照与 #if 指令相同的方式执行：即测试条件是否满足，并根据其结果决定编译或跳过其所控制的代码块，并在后一种情况下继续处理后续的 #elif 和 #else 指令。条件编译预处理块以 #endif 指令结束。

条件的求值

#if, #elif

表达式 是常量表达式。

表达式可含有形如“defined 标识符”或“defined (标识符)”的一元运算符。当此 标识符 已经被定义为宏名，或者此 标识符 为 __has_include (C++17 起)时结果为 1，否则结果为 ​0​。

在进行所有宏展开和 defined 及 __has_include (C++17 起) 表达式的求值后，任何非布尔字面量的标识符都被替换成数字 ​0​（这包含词法上为关键字的标识符，但不包括如 and 之类的代用记号）。

当 表达式 求值为非零值时，包含其所控制的代码块，否则跳过该代码块。

#ifdef, #ifndef

检查标识符是否被定义为宏名。

“#ifdef 标识符”与“#if defined 标识符”实质上等价。

“#ifndef 标识符”与“#if !defined 标识符”实质上等价。

示例

运行此代码

#define ABCD 2
#include <iostream>
 
int main()
{
 
#ifdef ABCD
    std::cout << "1: yes\n";
#else
    std::cout << "1: no\n";
#endif
 
#ifndef ABCD
    std::cout << "2: no1\n";
#elif ABCD == 2
    std::cout << "2: yes\n";
#else
    std::cout << "2: no2\n";
#endif
 
#if !defined(DCBA) && (ABCD < 2*4-3)
    std::cout << "3: yes\n";
#endif
}

输出：

1: yes
2: yes
3: yes

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。