C++ 预处理指令

一、概述

1、什么是预处理指令？

预处理指令是以 # 开头的命令，在 C++ 编译过程的预处理阶段执行。它们用于引入头文件、定义宏、条件编译等，编译器在正式编译前会先处理这些指令。

2. 文件包含指令

• #include <文件名>
  包含标准头文件。
• #include "文件名"
  包含用户自定义头文件。

3. 宏定义与取消

• #define 宏名 替换文本
  定义宏。
• #define 宏名(参数) 替换文本
  定义带参数的宏（宏函数）。
• #undef 宏名
  取消宏定义。

4. 条件编译指令

• #ifdef 宏名
  如果已定义宏，编译后续代码。
• #ifndef 宏名
  如果没有定义宏，编译后续代码。
• #if 表达式
  如果表达式为真，编译后续代码。
• #else
  与 #if、#ifdef、#ifndef 配合使用，条件不满足时编译后续代码。
• #elif 表达式
  相当于 else if，表达式为真时编译后续代码。
• #endif
  结束条件编译块。

5. 特殊指令

• #error 信息
  预处理时输出错误信息并终止编译。
• #pragma 参数
  编译器相关的特殊指令（如 #pragma once 只编译一次）。
• #line 行号 ["文件名"]
  修改当前行号和文件名，用于调试或特殊需求。

5. 预定义宏（不是指令，但常用）

这些宏在预处理阶段自动定义，常用于调试和日志：

• __FILE__
  当前文件名（字符串）。
• __LINE__
  当前行号（整数）。
• __DATE__
  文件编译日期（字符串）。
• __TIME__
  文件编译时间（字符串）。
• __func__
  当前函数名（C++11及以后）。

6. 示例汇总

#include <iostream>
#define PI 3.14159
#define SQUARE(x) ((x)*(x))

#ifndef PI
#error "PI 未定义"
#endif

int main() {
    std::cout << "文件名: " << __FILE__ << std::endl;
    std::cout << "行号: " << __LINE__ << std::endl;
    std::cout << "PI: " << PI << std::endl;
    std::cout << "SQUARE(5): " << SQUARE(5) << std::endl;
    return 0;
}

二、指令详解

#include 指令详解

1. 基本语法

#include <头文件名>
#include "头文件名"

• < > 用于系统头文件（如标准库），编译器会在系统目录查找。
• " " 用于用户自定义头文件，编译器会先在当前目录查找，再到系统目录查找。

2. 作用

将指定头文件的内容插入到当前位置。例如：

#include <iostream>
#include "myheader.h"

• #include <iostream> 引入标准输入输出库。
• #include "myheader.h" 引入自定义头文件。

3. 注意事项

• 避免重复包含，可以使用头文件保护：

#ifndef MYHEADER_H
#define MYHEADER_H
// 头文件内容
#endif

三、#define 指令详解

1. 基本语法

#define 宏名 替换文本

2. 作用

定义一个宏，在预处理阶段用替换文本替换宏名。

示例1：常量定义

#define PI 3.14159

使用 PI 就会被替换为 3.14159。

示例2：宏函数

#define SQUARE(x) ((x)*(x))
int y = SQUARE(5); // 展开为 ((5)*(5))

3. 注意事项

• 宏没有类型检查，可能导致意外的结果（比如宏函数参数带有表达式时）。
• 宏仅做文本替换，不分配内存。
• 使用括号包裹参数和整体表达式，避免优先级问题。

四、其他常用预处理指令

1. #ifdef / #ifndef / #endif

用于条件编译。

#ifdef DEBUG
    std::cout << "调试信息";
#endif

2. #undef

取消宏定义。

#undef PI

3. #pragma

用于编译器相关的特殊指令（如警告、优化等）。

#pragma once // 只包含一次，常用于头文件保护

综合示例

#define PI 3.14

#ifdef PI
#include <iostream>
#endif

int main() {
    std::cout << "圆周率为：" << PI << std::endl;
    return 0;
}

常见问题

1. 宏替换错误
   宏函数参数建议加括号，避免运算优先级问题。

2. 头文件重复包含
   使用 #ifndef 头文件保护或 #pragma once。

3. 调试宏
   条件编译可帮助调试和发布版本区分。

创作不易，点点关注！！！