C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- 变量模板(C++14 起)
- 整数字面量
- 聚合初始化
- 比较运算符
- 默认比较(C++20 起)
- 转义序列
- for 循环
- while 循环
- 用户定义转换
- SFINAE
- 主函数
- ASCII 码表
- 标识符
- 类型
- 内存模型
- 对象
- 基本概念
- 表达式
- 声明
- 初始化
- 函数
- 语句
- 类
- 运算符重载
- 模板
- 异常
- 事务性内存
- 占位符类型说明符 (C++11 起)
- decltype 说明符
- 函数声明
- final 说明符 (C++11 起)
- override 说明符(C++11 起)
- 引用声明
- 移动构造函数
- 移动赋值运算符
- 枚举声明
- constexpr 说明符(C++11 起)
- 列表初始化 (C++11 起)
- 构造函数与成员初始化器列表
- using 声明
- nullptr,指针字面量
- 基础类型
- 类型别名,别名模版 (C++11 起)
- 形参包
- 联合体声明
- 字符串字面量
- 用户定义字面量 (C++11 起)
- 属性说明符序列(C++11 起)
- Lambda 表达式 (C++11 起)
- noexcept 说明符 (C++11 起)
- noexcept 运算符 (C++11 起)
- alignof 运算符(C++11 起)
- alignas 说明符 (C++11 起)
- 存储类说明符
- 基于范围的 for 循环 (C++11 起)
- static_assert 声明
- 隐式转换
- 代用运算符表示
- 自增/自减运算符
- 折叠表达式(C++17 起)
- 类模板实参推导(C++17 起)
- 模板形参与模板实参
- if 语句
- inline 说明符
- 结构化绑定声明 (C++17 起)
- switch 语句
- 字符字面量
- 命名空间
- 求值顺序
- 复制消除
- consteval 说明符 (C++20 起)
- constinit 说明符 (C++20 起)
- 协程 (C++20)
- 模块 (C++20 起)
- 约束与概念 (C++20 起)
- new 表达式
- do-while 循环
- continue 语句
- break 语句
- goto 语句
- return 语句
- 动态异常说明
- throw 表达式
- try 块
- 命名空间别名
- 类声明
- cv(const 与 volatile)类型限定符
- 默认初始化
- 值初始化(C++03 起)
- 零初始化
- 复制初始化
- 直接初始化
- 常量初始化
- 引用初始化
- 值类别
- C++ 运算符优先级
- 布尔字面量
- 浮点字面量
- typedef 说明符
- 显式类型转换
- static_cast 转换
- dynamic_cast 转换
- const_cast 转换
- reinterpret_cast 转换
- delete 表达式
- 构造函数与成员初始化器列表
- this 指针
- 访问说明符
- 友元声明
- virtual 函数说明符
- explicit 说明符
- 静态成员
- 默认构造函数
- 复制构造函数
- 复制赋值运算符
- 析构函数
- 类模板
- 函数模板
- 显式(全)模板特化
- 汇编声明
- C++ 的历史
- 作用域
- 生存期
- 定义与单一定义规则(ODR)
- 名字查找
- 有限定的名字查找
- 无限定的名字查找
- 如同规则
- 未定义行为
- 翻译阶段
- 常量表达式
- 赋值运算符
- 算术运算符
- 逻辑运算符
- 成员访问运算符
- 其他运算符
- sizeof 运算符
- typeid 运算符
- 指针声明
- 数组声明
- 语言链接
- 详述类型说明符
- 默认实参
- 变长实参
- 实参依赖查找
- 重载决议
- 重载函数的地址
- 注入类名
- 非静态数据成员
- 非静态成员函数
- 嵌套类
- 派生类
- 空基类优化
- 抽象类
- 位域
- 转换构造函数
- 成员模板
- 模板实参推导
- 部分模板特化
- sizeof... 运算符
- 待决名
- 函数 try 块
- 扩充命名空间 std
- 字母缩写
- RAII
- 三/五/零之法则
- PImpl
- 零开销原则
- 类型
- 隐式转换
- 注释
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
常量表达式
定义能在编译时求值的表达式。
这种表达式能用做非类型模板实参、数组大小,并用于其他要求常量表达式的语境,例如
int n = 1; std::array<int, n> a1; // 错误:n 不是常量表达式 const int cn = 2; std::array<int, cn> a2; // OK:cn 是常量表达式
核心常量表达式
核心(core)常量表达式是求值过程中不会对下列任一者求值的表达式:
this
指针,但作为该表达式的一部分求值的constexpr
函数或constexpr
构造函数之中的则不算- 调用未声明为 constexpr 的函数(或构造函数)的函数调用表达式
constexpr int n = std::numeric_limits<int>::max(); // OK:max() 是 constexpr constexpr int m = std::time(NULL); // 错误:std::time() 非 constexpr
- 对声明为
constexpr
但未定义的函数进行的函数调用 - 对
constexpr
函数/构造函数模板实例化进行的函数调用,其中该实例化无法满足 constexpr 函数/构造函数的要求。 - (C++20 起) 对
constexpr
虚函数的函数调用,调用所用的对象不可用于常量表达式(见后述)且其生命期始于此表达式之外。 - 会超出实现定义限制的表达式
- 求值导致任何形式的核心语言未定义行为(包含有符号整数溢出、除以零、数组边界外的指针算术等)的表达式。是否检测标准库的未定义行为是未指明的。
constexpr double d1 = 2.0/1.0; // OK constexpr double d2 = 2.0/0.0; // 错误:未定义 constexpr int n = std::numeric_limits<int>::max() + 1; // 错误:溢出 int x, y, z[30]; constexpr auto e1 = &y - &x; // 错误:未定义 constexpr auto e2 = &z[20] - &z[3]; // OK constexpr std::bitset<2> a; constexpr bool b = a[2]; // UB,但是否检测未指定
- (C++17 前)lambda 表达式
- 左值到右值隐式转换,除非……
- 应用到指代可用于常量表达式(见后述)的对象的非 volatile 泛左值,
int main() { const std::size_t tabsize = 50; int tab[tabsize]; // OK : tabsize 是常量表达式 // 因为 tabsize 可用于常量表达式 // 因为它有 const 限定的整数类型,且其初始化器是常量初始化器 std::size_t n = 50; const std::size_t sz = n; int tab2[sz]; // 错误: sz 不是常量表达式 // 因为 sz 不可用于常量表达式 // 因为其初始化器不是常量初始化器 } }
- 或应用到拥有字面类型,并指代生命期始于此表达式的求值之内的非 volatile 对象
- 应用到指代可用于常量表达式(见后述)的对象的非 volatile 泛左值,
- 对 union 的不活跃成员或其子对象实施的左值到右值隐式转换或修改操作(即使它与活跃成员共享公共起始序列也是如此)
- (C++20 起) 应用到拥有不确定值的对象的左值到右值隐式转换
- 对活跃成员(若存在)为 mutable 的 union 调用隐式定义的复制/移动构造函数或复制/移动赋值运算符,除非该 union 对象的生命期始于此表达式的求值之内
- (C++17 起) (C++20 前)会更改 union 的活跃成员的赋值表达式,或对重载的赋值运算符的调用
- 指代引用类型的变量或数据成员的 标识表达式,除非该引用可用于常量表达式,或其生命始于此表达式的求值之内
- 从 cv void* 转换到任何对象指针类型
- (C++20 前)
dynamic_cast
reinterpret_cast
- (C++20 前)伪析构函数调用
- (C++14 前)自增或自减运算符
-
(C++14 起) 修改对象,除非该对象拥有非 volatile 字面类型,且其生命期始于此表达式的求值之内
constexpr int incr(int& n) { return ++n; } constexpr int g(int k) { constexpr int x = incr(k); // 错误:incr(k) 不是核心常量表达式 // 因为 k 的生命期始于表达式 incr(k) 之外 return x; } constexpr int h(int k) { int x = incr(k); // OK:不要求 x 以核心常量表达式初始化 return x; } constexpr int y = h(1); // OK:以值 2 初始化 y // h(1) 是核心常量表达式 // 因为 k 的生命期始于表达式 h(1) 之内
- (C++20 前)应用到多态类型泛左值的
typeid
表达式 - new 表达式,除非选择的分配函数是全局可替换分配函数且此表达式的求值内解分配其所分配的存储 (C++20 起)
- delete 表达式,除非它解分配于此表达式的求值内分配的存储区域 (C++20 起)
- (C++20 起)调用 std::allocator<T>::allocate ,除非于此表达式的求值内解分配其所分配的存储
- (C++20 起)调用 std::allocator<T>::deallocate ,除非它解分配于此表达式的求值内分配的存储区域
- (C++20 起)await 表达式或 yield 表达式
- (C++20 起)结果未指定三路比较
- 结果未指明的相等或关系运算符
- (C++14 前)赋值或复合赋值运算符
- throw 表达式
- (C++20 起) 汇编声明
- 宏 va_arg 的调用,是否能求值宏 va_start 是未指定的
- (C++20 起)会抛出异常的
dynamic_cast
或typeid
表达式 - lambda 表达式中,提及
this
或提及定义于该 lambda 之外的变量,若它是一次 ODR 式使用void g() { const int n=0; constexpr int j=*&n; // OK:lambda 表达式之外 [=]{ constexpr int i=n; // OK:'n' 未被 ODR 式使用且未在此处被俘获。 constexpr int j=*&n;// 非良构:'&n' ODR 式使用了 'n'。 }; }
注意,若 ODR 式使用发生于对闭包的函数调用中,则它不涉指
this
或外围变量,因为它所访问的是该闭包的数据成员// OK:'v' 与 'm' 被 ODR 式使用,但未出现于嵌套于 lambda 内的常量表达式中 auto monad = [](auto v){return [=]{return v;};}; auto bind = [](auto m){return [=](auto fvm){return fvm(m());};}; // 在常量表达式求值中,创建对自动对象的俘获是 OK 的。 static_assert(bind(monad(2))(monad)() == monad(2)());
(C++17 起)
本节未完成 原因:需要更多小示例和更少标准用语 |
注意:核心常量表达式本身并无任何直接的语义含义:表达式必须为下列子集之一,才可以在特定语境中使用:
可用于常量表达式
上述列表中,变量可用于常量表达式,若它是
- constexpr 变量,或
- 拥有下列类型的常量初始化的变量
- 引用类型,或
- const 限定的整数或枚举类型。
对象或引用可用于常量表达式,若它是
- 可用于常量表达式的变量,或
- (C++20 起) 模板形参对象,或
- 字符串字面量对象,或
- 以上任一者的非 mutable 子对象或引用成员,或
- 非 volatile 的 const 限定整数类或枚举类型的,以常量表达式初始化的完整临时对象。
const std::size sz = 10; // sz 可用于常量表达式
整型常量表达式
整型常量表达式是隐式转换成纯右值的整型或无作用域枚举类型的表达式,其中被转换的表达式是核心常量表达式。若将类类型表达式用在期待整型常量表达式之处,则表达式将被按语境隐式转换成整型或无作用域枚举类型。
下列语境要求整型常量表达式:
(C++14 前) |
- 位域长度
- 底层类型未固定时的枚举初始化器
|
(C++14 前) |
- 对齐。
经转换的常量表达式
T
类型的经转换的(converted)常量表达式是隐式转换到 T 类型的表达式,其中被转换后表达式是常量表达式,且隐式转换序列只含有:
- constexpr 用户定义转换(故类能用于期待整数类型之处)
- 左值到右值转换
- 整型提升
- 非窄化整型转换
|
(C++17 起) |
- 而若发生任何引用绑定,则它是直接绑定(非构造临时对象者)
下列语境要求经转换的常量表达式:
(C++14 起) |
- 整型与枚举 (C++17 前)非类型模板实参。
按语境转换(contextually converted)的 bool 类型常量表达式是按语境转换到 bool 的表达式,其中转换后的表达式是常量表达式,且转换序列只含上述转换。
下列语境要求按语境转换的 bool 类型常量表达式:
(C++17 起) |
(C++20 起) |
常量表达式
常量表达式(constant expression)是
|
(C++14 起) | ||
常量表达式是字面常量表达式,引用常量表达式,或地址常量表达式。 字面常量表达式是非指针字面类型(经语境所要求的转换后)的纯右值核心常量表达式。数组或类类型的字面常量表达式要求每个子对象以常量表达式初始化。 引用常量表达式是指代具有静态存储期的对象或指代函数的左值核心常量表达式。 地址常量表达式是 std::nullptr_t 类型或指针类型(经语境所要求的转换后)的纯右值核心常量表达式,它指向具有静态存储期的对象,指向具有静态存储期的数组末尾后一位置,指向函数,或为空指针。 |
(C++14 前) |
void test() { static const int a = std::random_device{}(); constexpr const int& ra = a; // OK:a 是泛左值常量表达式 constexpr int ia = a; // 错误:a 不是纯右值常量表达式 const int b = 42; constexpr const int& rb = b; // 错误:b 不是泛左值常量表达式 constexpr int ib = b; // OK:b 是纯右值常量表达式 }
注解
不容许实现将库函数声明为 常量表达式中不容许具名返回值优化( NRVO ),而返回值优化( RVO )是强制要求的。 |
(C++14 起) |
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
CWG 1313 | C++11 | 容许未定义行为,且禁止所有指针减法 | 同数组内的指针减法 OK ,禁止 UB |
CWG 1952 | C++11 | 要求诊断标准库未定义行为 | 未指定是否诊断库 UB |
CWG 2167 | C++14 | 求值中局部的非成员引用会令求值为非 constexpr | 允许非成员引用 |
CWG 2299 | C++11 | <cstdarg> 中的宏能否用于常量求值不明确 | 禁止 va_arg ,未指定 va_start
|
参阅
constexpr 说明符
|
说明变量或函数的值能在编译时计算(C++11) |
(C++11)(C++17 中弃用)(C++20 中移除) |
检查类型是否为字面类型 (类模板) |