预处理器

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键词

预处理器

语句

表达式

初始化

声明

函数

杂项

C 的历史

技术规范

 

预处理器

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C23)(C23)

#define#undef#,## 运算符

#include__has_include (C23)

#error#warning (C23)

#pragma_Pragma (C99)

#line

#embed__has_embed (C23)(C23)

 

预处理器在翻译阶段4执行，在编译之前。预处理的结果是一个单独的文件，然后将其传递给实际的编译器。

指令

预处理指令控制预处理器的行为。每个指令占据一行，格式如下：

• # 字符
• 预处理指令（define, undef, include, if, ifdef, ifndef, else, elif, elifdef, elifndef(C23 起), endif, line, embed(C23 起), error, warning(C23 起), pragma 之一）
• 参数（取决于指令）
• 换行符。

允许空指令（# 后跟换行符），且无任何效果。

功能

预处理器具有以下源文件转换功能：

• 有条件地编译源文件的部分（由指令#if, #ifdef, #ifndef, #else, #elif, #elifdef, #elifndef(C23 起) 和 #endif 控制）。
• 替换文本宏，同时可能拼接或引用标识符（由指令 #define 和 #undef，以及运算符 # 和 ## 控制）
• 包含其他文件（由指令 #include 控制 并通过 __has_include 检查(C23 起)）
• 导致错误 或 警告(C23 起)（分别由指令 #error 或 #warning(C23 起) 控制）

预处理器的以下方面可以被控制：

• 实现定义的行为（由指令 #pragma 和运算符 _Pragma(C99 起) 控制）
• 可供预处理器使用的文件名和行信息（由指令 #line 控制）

参考

• C23 标准 (ISO/IEC 9899:2024)

• 6.10 预处理指令 (p: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 6.10 预处理指令 (p: 117-129)

• C11 标准 (ISO/IEC 9899:2011)

• 6.10 预处理指令 (p: 160-178)

• C99 标准 (ISO/IEC 9899:1999)

• 6.10 预处理指令 (p: 145-162)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 3.8 预处理指令

另请参阅

C 文档 中的 预定义宏符号

C 文档 中的 宏符号索引

C++ 文档 中的 预处理器