预处理器

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

C++ 语言

一般主题
预处理器 注释	关键词 转义序列
流程控制
条件执行语句
if	switch
重复语句（循环）
for 范围 for (C++11)	while do-while
跳转语句
continue - break	goto - return
函数
函数声明
Lambda 函数声明
inline 说明符
动态异常说明 (C++20 前)
noexcept 说明符 (C++11)
异常
throw 表达式	try-catch 块
命名空间
命名空间声明	命名空间别名
类型
基础类型 枚举类型 函数类型	复合类型 联合体类型
说明符
decltype (C++11) auto (C++11) alignas (C++11)	const/volatile constexpr (C++11)
存储期说明符
初始化
默认初始化 值初始化 零初始化 复制初始化 直接初始化	聚合初始化 列表初始化 (C++11) 常量初始化 引用初始化

表达式
值类别 求值顺序	运算符 运算符优先级
替代表示
字面量
布尔 - 整数 - 浮点
字符 - 字符串 - nullptr (C++11)
用户定义 (C++11)
工具
属性 (C++11)
类型
typedef 声明
类型别名声明 (C++11)
类型转换
隐式转换 - 显式转换
static_cast - dynamic_cast
const_cast - reinterpret_cast
内存分配
new 表达式	delete 表达式
类
类声明 构造函数 this 指针	访问说明符 friend 说明符
特定于类的函数性质
虚函数 override 说明符 (C++11) final 说明符 (C++11)	explicit (C++11) static
特殊成员函数
默认构造函数 复制构造函数 移动构造函数 (C++11)	复制赋值 移动赋值 (C++11) 析构函数
模板
类模板 函数模板	模板特化 参数包 (C++11)
杂项
内联汇编	C++ 的历史

 

预处理器

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C++23)(C++23)

#define#undef#,## 运算符

#include__has_include (C++17)

#error#warning (C++23)

#pragma_Pragma (C++11)

#line

 

预处理器在编译前的翻译阶段 4 执行。预处理的结果是单个文件，接下来它会被传递给实际编译器。

指令

预处理指令控制预处理器的行为。每个指令占据一行并拥有下列格式：

• # 字符
• 包含以下内容的序列：

• 由标准定义的指令名（见下文）后随对应的实参，或
• 一个或多个预处理记号，其中第一个记号不是由标准定义的指令名，此时该指令受条件性支持并且语义由实现定义（例如常用的非标准扩展预处理指令 #warning 会在编译时放出一条用户定义的消息），或
• 什么也不含，此时该指令没有效果。

• 换行符

module 和 import 指令也是预处理指令。

(C++20 起)

预处理指令不得来自宏展开。

#define EMPTY
EMPTY   #   include <file.h> // 不是预处理指令

能力

预处理器有能力翻译源文件：

• 有条件编译源文件的某些部分（由 #if、#ifdef、#ifndef、#else、#elif、#elifdef、#elifndef (C++23 起) 和 #endif 指令控制）。
• 替换文本宏，同时可能对标识符进行拼接或加引号（由 #define 和 #undef 指令与 # 和 ## 运算符控制）。
• 包含其他文件（由 #include 指令控制并以 __has_include 检查 (C++17 起)）。
• 导致错误或警告 (C++23 起)（由指令 #error 或 #warning (C++23 起) 控制）。

能控制预处理器的下列方面：

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

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
CWG 2001	C++98	使用未由标准定义的预处理指令的行为不明确	受条件性支持