C++ 预处理器是在编译之前对源代码进行处理的工具。它负责处理代码中的宏、文件包含、条件编译等指令。预处理器并不直接编译代码，而是对代码进行预处理，以便编译器能够正确地解析和编译源代码。

预处理器的指令通常以 # 开头，以下是 C++ 中常用的预处理器指令。

1. 宏定义 (#define)

宏定义用于在编译时替换源代码中的某些文本。宏可以是常量，也可以是函数。

常量宏

#include <iostream>
using namespace std;

#define PI 3.14159  // 定义一个常量宏

int main() {
    cout << "The value of PI is " << PI << endl;
    return 0;
}

输出：

The value of PI is 3.14159

函数宏

#include <iostream>
using namespace std;

#define SQUARE(x) ((x) * (x))  // 定义一个宏函数

int main() {
    int result = SQUARE(5);  // 使用宏函数
    cout << "The square of 5 is " << result << endl;
    return 0;
}

输出：

The square of 5 is 25

说明：

• #define 用于定义常量或宏函数。宏函数在调用时会进行替换，类似于文本替换。

2. 条件编译 (#if, #else, #elif, #endif)

条件编译允许根据特定的条件来决定是否编译某段代码。这在跨平台开发或调试时特别有用。

基本条件编译

#include <iostream>
using namespace std;

#define DEBUG

int main() {
    #ifdef DEBUG  // 如果定义了 DEBUG
        cout << "Debugging is enabled" << endl;
    #else
        cout << "Debugging is not enabled" << endl;
    #endif
    return 0;
}

输出：

Debugging is enabled

其他条件编译指令

#include <iostream>
using namespace std;

#define VERSION 2

int main() {
    #if VERSION == 1
        cout << "Version 1" << endl;
    #elif VERSION == 2
        cout << "Version 2" << endl;
    #else
        cout << "Unknown version" << endl;
    #endif
    return 0;
}

输出：

Version 2

说明：

• #ifdef、#ifndef、#if、#elif、#else 和 #endif 允许在编译时根据特定条件来编译不同的代码块。
• #ifdef：如果已定义某宏，编译对应的代码。
• #ifndef：如果未定义某宏，编译对应的代码。
• #if：根据条件表达式的值来编译代码。

3. 文件包含 (#include)

#include 指令用于将外部文件的内容插入到当前源文件中。通常用来引入头文件。

系统头文件与自定义头文件

#include <iostream>  // 系统头文件
#include "myheader.h"  // 自定义头文件

int main() {
    cout << "Hello, World!" << endl;
    return 0;
}

说明：

• #include <filename> 用于引入标准库的头文件。
• #include "filename" 用于引入自定义的头文件，编译器会首先在当前目录查找该文件。

4. 宏取消 (#undef)

#undef 用于取消先前定义的宏。如果一个宏不再需要，使用 #undef 可以取消它的定义。

#include <iostream>
using namespace std;

#define PI 3.14159
#undef PI  // 取消定义 PI

int main() {
    // cout << "PI is " << PI << endl;  // 这里 PI 已经未定义，编译器会报错
    return 0;
}

说明：

• #undef 用于取消宏的定义，使其在后续代码中不可用。

5. 宏替换规则

在使用宏时，预处理器将宏的名称直接替换为定义的内容。在替换时需要注意优先级和括号问题，避免错误的计算结果。

宏替换问题

#include <iostream>
using namespace std;

#define SQUARE(x) x * x

int main() {
    int result = SQUARE(5 + 1);
    cout << "The result is " << result << endl;  // 结果是 5 + 1 * 5 + 1，即 11
    return 0;
}

输出：

The result is 11

说明：

• SQUARE(5 + 1) 在预处理时会被替换为 5 + 1 * 5 + 1，这并不是我们期望的 (5 + 1) * (5 + 1)，因为没有加上必要的括号。

改正方式

#include <iostream>
using namespace std;

#define SQUARE(x) ((x) * (x))  // 添加括号来避免优先级问题

int main() {
    int result = SQUARE(5 + 1);  // 结果是 (5 + 1) * (5 + 1)
    cout << "The result is " << result << endl;  // 结果是 36
    return 0;
}

输出：

The result is 36

说明：

• 使用括号包裹宏的参数和整个宏替换表达式，确保正确的优先级和运算顺序。

6. 预定义宏

C++ 预处理器还定义了一些预设的宏，如下：

• __DATE__：当前日期（字符串格式："Mmm dd yyyy"）
• __TIME__：当前时间（字符串格式："hh:mm:ss"）
• __FILE__：当前文件名（字符串格式）
• __LINE__：当前行号（整数）

示例

#include <iostream>
using namespace std;

int main() {
    cout << "File: " << __FILE__ << endl;
    cout << "Line: " << __LINE__ << endl;
    cout << "Date: " << __DATE__ << endl;
    cout << "Time: " << __TIME__ << endl;
    return 0;
}

输出：

File: main.cpp
Line: 10
Date: Mar 29 2025
Time: 14:03:12

7. 小结

C++ 预处理器提供了一系列强大的功能来处理代码的预编译过程，如宏定义、条件编译、文件包含、取消宏定义等。通过合理使用预处理器指令，可以提高代码的可维护性、灵活性，并解决跨平台编程中的问题。

常见预处理器指令总结：

• #define：定义宏常量或宏函数
• #undef：取消宏定义
• #include：包含头文件
• #if, #else, #elif, #endif：条件编译
• #ifdef, #ifndef：判断宏是否已定义
• __DATE__, __TIME__, __FILE__, __LINE__：预定义宏