C++从入门到精通专栏（2.4）-- 面向过程编程：预处理器指令：宏定义、文件包含、条件编译-CSDN博客

#include <iostream>
using namespace std;

#define PI 3.14159  // 定义圆周率常量

int main() {
    double radius = 5.0;
    double area = PI * radius * radius;  // 使用宏定义的 PI
    cout << "Circle area: " << area << endl;

    return 0;
}

1.2 带参数的宏定义

宏定义还可以带参数，类似于函数调用。带参数的宏定义在展开时会将参数替换为实际传递的值。

基本语法：

cpp

深色版本

#define macro_name(param1, param2, ...) replacement

示例：

cpp

深色版本

#include <iostream>
using namespace std;

#define SQUARE(x) ((x) * (x))  // 定义带参数的宏

int main() {
    int a = 5;
    int b = 10;
    cout << "Square of " << a << " is " << SQUARE(a) << endl;
    cout << "Square of " << b << " is " << SQUARE(b) << endl;

    return 0;
}

注意事项：

宏定义中的参数需要用括号括起来，以避免运算符优先级问题。例如，SQUARE(x) 应该定义为 ((x) * (x)) 而不是 x * x，否则可能会导致错误的结果。
宏定义不会进行类型检查，因此使用时要特别小心，确保传递的参数类型正确。

1.3 宏定义的作用范围

宏定义的作用范围从定义处开始，直到文件结束或遇到 #undef 指令为止。你可以使用 #undef 来取消宏定义。

示例：

cpp

深色版本

#include <iostream>
using namespace std;

#define PI 3.14159

int main() {
    double radius = 5.0;
    double area = PI * radius * radius;
    cout << "Circle area: " << area << endl;

    #undef PI  // 取消宏定义
    // 从这里开始，PI 不再有效

    return 0;
}

二、文件包含（`#include`）

文件包含指令允许你将一个文件的内容插入到当前文件中。这在C++中非常常见，用于引入标准库头文件或自定义头文件。文件包含可以减少代码重复，提高代码的模块化和可维护性。

2.1 包含标准库头文件

标准库头文件提供了C++标准库中定义的函数、类和宏。包含标准库头文件时，使用尖括号 < >。

示例：

cpp

深色版本

#include <iostream>  // 引入输入输出流库
#include <cmath>     // 引入数学函数库
#include <string>    // 引入字符串库

int main() {
    std::cout << "Hello, World!" << std::endl;
    double result = std::sqrt(16.0);  // 使用数学库中的 sqrt 函数
    std::cout << "Square root of 16 is " << result << std::endl;

    return 0;
}

2.2 包含自定义头文件

自定义头文件通常用于组织代码，将函数声明、类定义等放在单独的文件中。包含自定义头文件时，使用双引号 ""。

示例： 假设有一个自定义头文件 myfunctions.h，其中包含一些函数声明：

cpp

深色版本

// myfunctions.h
#ifndef MYFUNCTIONS_H
#define MYFUNCTIONS_H

void printHello();
int add(int a, int b);

#endif  // MYFUNCTIONS_H

在主程序中包含该头文件：

cpp

深色版本

#include "myfunctions.h"  // 引入自定义头文件

int main() {
    printHello();  // 调用自定义函数
    int sum = add(5, 10);
    std::cout << "Sum: " << sum << std::endl;

    return 0;
}

注意事项：

使用 #ifndef、#define 和 #endif 可以防止头文件被多次包含，避免重复定义的问题。这种机制称为“头文件保护”或“包含卫士”。

三、条件编译

条件编译允许你根据某些条件选择性地编译代码。通过条件编译，你可以在不同的编译环境下启用或禁用特定的代码段，或者为调试和发布版本编写不同的代码。

3.1 `#if`、`#elif`、`#else` 和 `#endif`

这些指令用于根据条件选择性地编译代码块。#if 后面可以跟一个表达式，如果表达式的值为真，则编译相应的代码块；否则，跳过该代码块。#elif 和 #else 用于提供多个分支。

基本语法：

cpp

深色版本

#if condition1
    // 编译条件1为真的代码
#elif condition2
    // 编译条件2为真的代码
#else
    // 编译其他情况的代码
#endif

示例：

cpp

深色版本

#include <iostream>

#define DEBUG 1

int main() {
    int x = 10;

    #if DEBUG
        std::cout << "Debug mode: x = " << x << std::endl;
    #else
        std::cout << "Release mode: x = " << x << std::endl;
    #endif

    return 0;
}

注意事项：

DEBUG 是一个预处理器宏，通常在编译时通过编译器选项定义。例如，在GCC中可以使用 -DDEBUG 选项来定义 DEBUG 宏。

3.2 `#ifdef` 和 `#ifndef`

#ifdef 和 #ifndef 用于检查某个宏是否已定义。#ifdef 表示如果宏已定义，则编译相应的代码块；#ifndef 表示如果宏未定义，则编译相应的代码块。

基本语法：

cpp

深色版本

#ifdef macro_name
    // 编译宏已定义的代码
#endif

#ifndef macro_name
    // 编译宏未定义的代码
#endif

示例：

cpp

深色版本

#include <iostream>

#define FEATURE_ENABLED 1

int main() {
    #ifdef FEATURE_ENABLED
        std::cout << "Feature is enabled." << std::endl;
    #else
        std::cout << "Feature is disabled." << std::endl;
    #endif

    return 0;
}

3.3 `#pragma` 指令

#pragma 指令用于向编译器发送特殊指令，控制编译器的行为。不同编译器对 #pragma 的支持可能有所不同，因此使用时需要注意编译器的文档。

示例：

cpp

深色版本

#pragma once  // 确保头文件只被包含一次

#pragma once 是一种常用的替代方案，用于防止头文件被多次包含。与 #ifndef、#define 和 #endif 相比，#pragma once 更简洁，但并非所有编译器都支持它。

四、总结

预处理器指令是C++编程中不可或缺的一部分，它们在编译前对源代码进行处理，提供了宏定义、文件包含和条件编译等功能。通过合理使用预处理器指令，你可以编写更加灵活、可维护的代码，适应不同的编译环境和需求。

宏定义：用于定义常量、表达式或代码片段，提高代码的可读性和可维护性。
文件包含：用于引入标准库头文件或自定义头文件，减少代码重复，提高模块化。
条件编译：用于根据条件选择性地编译代码，适应不同的编译环境或调试需求。

五、练习题

宏定义：
- 编写一个程序，定义一个宏 MAX(a, b)，用于计算两个数的最大值。然后，编写一个主函数，测试该宏的功能。
文件包含：
- 创建一个自定义头文件 mathutils.h，其中包含两个函数的声明：int add(int a, int b) 和 int multiply(int a, int b)。然后，在主程序中包含该头文件，并调用这两个函数。
条件编译：
- 编写一个程序，使用 #ifdef 和 #endif 实现条件编译。定义一个宏 DEBUG，并在调试模式下输出额外的调试信息。在发布模式下，不输出调试信息。
综合应用：
- 编写一个程序，定义一个宏 LOG(message)，用于在调试模式下输出日志信息。使用条件编译控制 LOG 宏的行为：在调试模式下输出日志，在发布模式下忽略日志。创建一个自定义头文件 logger.h，并将 LOG 宏定义放在该头文件中。在主程序中包含 logger.h 并测试 LOG 宏的功能。