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++ 关键词
基于范围的 for 循环 (C++11 起)
在一个范围上执行 for
循环。
用作对范围中的各个值(如容器中的所有元素)进行操作的传统 for 循环的更加可读的等价版本。
语法
属性(可选) for ( 范围声明 : 范围表达式 ) 循环语句
|
(C++20 前) | ||||||||
属性(可选) for ( 初始化语句(可选)范围声明 : 范围表达式 ) 循环语句
|
(C++20 起) | ||||||||
属性 | - | 任何数量的属性 |
初始化语句(C++20) | - | 以下之一:
|
范围声明 | - | 一个具名变量的声明,其类型是由 范围表达式 所表示的序列的元素的类型,或该类型的引用。通常用 auto 说明符进行自动类型推导。 |
范围表达式 | - | 任何可以表示一个合适的序列(数组,或定义了 begin 和 end 成员函数或自由函数的对象,见下文)的表达式,或一个花括号初始化器列表。
|
循环语句 | - | 任何语句,常为一条复合语句,它是循环体 |
范围声明 可以是结构化绑定声明 for (auto&& [first,second] : mymap) { // 使用 first 和 second } |
(C++17 起) |
解释
上述语法产生的代码等价于下列代码(__range
、__begin
和 __end
仅用于阐释):
|
(C++17 前) |
|
(C++17 起) (C++20 前) |
|
(C++20 起) |
对 范围表达式 求值以确定要迭代的序列或范围。依次对序列的每个元素进行解引用,并赋值给具有 范围声明 中所给定的类型和名字的变量。
首表达式
与 尾表达式
定义如下:
- 若 范围表达式 是数组类型的表达式,则
首表达式
为 __range 而尾表达式
为 (__range + __bound),其中__bound
是数组的元素数目(若数组大小未知或拥有不完整类型,则程序非良构) - 若 范围表达式 是同时拥有名为 begin 以及名为 end 的成员的类类型
C
的表达式(不管这些成员的类型或可见性),则首表达式
为 __range.begin() 而尾表达式
为 __range.end(); - 否则,
首表达式
为 begin(__range) 而尾表达式
为 end(__range),通过实参依赖查找进行查找(不进行非 ADL 查找)。
正如传统循环一样,break 语句可用于提早退出循环,而 continue 语句能用于以下个元素重新开始循环。
临时范围表达式
若 范围表达式 返回临时量,则其生存期被延续到循环结尾,如绑定到转发引用 __range
所示,但要注意 范围表达式 中任何临时量生存期都不被延长。
for (auto& x : foo().items()) { /* .. */ } // 若 foo() 返回右值则为未定义行为
此问题可用 初始化语句 变通解决: for (T thing = foo(); auto& x : thing.items()) { /* ... */ } // OK |
(C++20 起) |
注解
若初始化器(范围表达式)是花括号初始化器列表,则 __range
被推导为 std::initializer_list<>&&。
在泛型代码中,使用推导的转发引用,如 for (auto&& var : sequence),是安全且受推荐的做法。
若范围类型拥有名为 begin
的成员和名为 end
的成员,则使用成员解释方案。其中不顾成员是类型、数据成员、函数还是枚举项,且不顾其可访问性。从而如 class meow { enum { begin = 1, end = 2}; /* 类的剩余部分 */ }; 的类不能用于基于范围的 for 循环,即使存在命名空间作用域的 begin/end 函数也是如此。
虽然通常在 循环语句 中使用声明于 范围声明 的变量,但并不要求这么做。
从 C++17 开始,首表达式 和 尾表达式 的类型不必相同,而且实际上 尾表达式 的类型不必是迭代器:它只需能与一个迭代器比较是否不等即可。这使得以一个谓词(例如“迭代器指向空字符”)对范围进行分界成为可能。 |
(C++17 起) |
当基于范围的 for 循环被用于一个具有写时复制语义的(非 const)对象时,它可能会通过(隐式)调用非 const 的 begin()
成员函数触发深层复制。
如果想要避免这种行为(比如循环实际上不会修改这个对象),可以使用 std::as_const: struct cow_string { /* ... */ }; // 写时复制的字符串 cow_string str = /* ... */; // for(auto x : str) { /* ... */ } // 可能会导致深层复制 for(auto x : std::as_const(str)) { /* ... */ } |
(C++17 起) |
关键词
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
P0962R1 | C++11 | 若 begin 和 end 之一存在就使用成员解释方案 | 仅若两者都存在才使用 |
示例
#include <iostream> #include <vector> int main() { std::vector<int> v = {0, 1, 2, 3, 4, 5}; for (const int& i : v) // 以 const 引用访问 std::cout << i << ' '; std::cout << '\n'; for (auto i : v) // 以值访问,i 的类型是 int std::cout << i << ' '; std::cout << '\n'; for (auto& i : v) // 以引用访问,i 的类型是 int& std::cout << i << ' '; std::cout << '\n'; for (int n : {0, 1, 2, 3, 4, 5}) // 初始化器可以是花括号初始化器列表 std::cout << n << ' '; std::cout << '\n'; int a[] = {0, 1, 2, 3, 4, 5}; for (int n : a) // 初始化器可以是数组 std::cout << n << ' '; std::cout << '\n'; for (int n : a) std::cout << 1 << ' '; // 不必使用循环变量 std::cout << '\n'; }
输出:
0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 1 1 1 1 1 1
参阅
应用函数到范围中的元素 (函数模板) |