C++ 进阶笔记：宏

C++ 进阶笔记：宏 (Macros)

一、 宏的本质

宏（Macro）是 C++ 预处理器（Preprocessor） 的功能。它在真正的编译开始之前运行，执行的是简单的 "查找与替换" 操作。

• 指令 ：以 #define 开头。
• 阶段：发生在预处理阶段（Textual Replacement），编译器看到的已经是替换后的代码。

---

二、 基础宏示例：文本替换

虽然可以用来简化代码，但过度使用会降低可读性。

#define WAIT std::cin.get()
#define OPEN_BRACE {

int main() 
OPEN_BRACE // 替换为 {
    int a = 5;
    WAIT;      // 替换为 std::cin.get()
}

Cherno 的建议：不要像上面这样替换括号或基本语法，这会让其他开发者（或未来的你）感到极其困惑。

---

三、 参数化宏 (Function-like Macros)

宏可以像函数一样接收参数，但它没有类型检查，只是简单的占位符替换。

#define LOG(x) std::cout << x << std::endl

int main() {
    LOG("Hello World!"); // 展开为 std::cout << "Hello World!" << std::endl;
    LOG(5);              // 展开为 std::cout << 5 << std::endl;
}

---

四、 条件编译：宏的最强用法 (工业级应用 ⭐)

这是宏在 C++ 中最无可替代的场景。我们可以根据编译配置（Debug/Release）来决定代码是否生成。

场景：仅在 Debug 模式下开启日志

#include <iostream>

// 假设我们在项目属性中为 Debug 配置定义了 PR_DEBUG
#ifdef PR_DEBUG
    #define LOG(x) std::cout << x << std::endl
#else
    #define LOG(x) // 在 Release 模式下，LOG(x) 会被替换为空白
#endif

int main() {
    LOG("Checking database connection..."); // Debug 模式可见，Release 模式下此行消失
    return 0;
}

• 性能优势：在 Release 模式下，日志代码完全不进入编译器，不产生任何二进制指令，实现零性能损耗。

---

五、 实用技巧：多行宏与内置宏

1. 多行宏 (使用反斜杠 \)

如果宏逻辑较长，可以使用 \ 换行（注意反斜杠后不能有空格）。

#define INIT_LOG() \
    std::cout << "Log System Initialized..." << std::endl; \
    std::cout << "Working Directory: " << __FILE__ << std::endl

2. 调试辅助宏

C++ 内置了一些非常有用的宏，用于追踪代码执行位置：

• __FILE__：当前源文件的路径。
• __LINE__：当前代码所在的行号。

#define ASSERT_LOG(x) std::cout << "Error in " << __FILE__ << " at line " << __LINE__ << ": " << x << std::endl

---

六、 总结与注意事项

1. 调试困难：由于宏是文本替换，调试器（Debugger）无法进入宏内部。
2. 无类型安全：宏不关心类型，容易引发隐蔽的 Bug。
3. 慎用 ：能用 const、constexpr、inline 函数或 template 解决的问题，优先不要使用宏。
4. 数据库开发应用 ：在数据库引擎中，宏常用于 断言 (Assert) 、平台兼容处理 (Windows/Linux) 和 错误代码统一封装。