std::span
来自cppreference.com
| 定义于头文件 <span>
|
||
| template< class T, |
(C++20 起) | |
类模板 span 所描述的对象能指代对象的相接序列，序列的首元素在零位置。 span 能拥有静态长度，该情况下序列中的元素数已知并编码于类型中，或拥有动态长度。
典型实现只保有二个成员：指向 T 的指针和大小。
目录 |
[编辑] 模板形参
| T | - | 元素类型；必须是完整类型且非抽象类 |
| Extent | - | 序列中的元素数，或若它为动态则为 std::dynamic_extent
|
[编辑] 成员类型
| 成员类型 | 定义 |
element_type
|
T
|
value_type
|
std::remove_cv_t<T> |
index_type
|
std::size_t |
difference_type
|
std::ptrdiff_t |
pointer
|
T*
|
const_pointer
|
const T*
|
reference
|
T&
|
const_reference
|
const T&
|
iterator
|
实现定义的 遗留随机访问迭代器 (LegacyRandomAccessIterator) 、常量表达式迭代器 (ConstexprIterator) 兼 遗留连续迭代器 (LegacyContiguousIterator) ，其 value_type 为 value_type
|
const_iterator
|
实现定义的常 遗留随机访问迭代器 (LegacyRandomAccessIterator) 、常量表达式迭代器 (ConstexprIterator) 兼 遗留连续迭代器 (LegacyContiguousIterator) ，其 value_type 为 value_type
|
reverse_iterator
|
std::reverse_iterator<iterator> |
const_reverse_iterator
|
std::reverse_iterator<const_iterator> |
注意：若 T 无 const 限定则 iterator 为可变迭代器。
容器 (Container) 的迭代器类型上的所有要求亦应用于 span 的 iterator 和 const_iterator 类型。
[编辑] 成员常量
| static constexpr std::size_t extent = Extent; |
||
[编辑] 成员函数
构造 span (公开成员函数) | |
赋值 span (公开成员函数) | |
迭代器 | |
| 返回指向序列起始的迭代器 (公开成员函数) | |
| 返回指向序列末尾的迭代器 (公开成员函数) | |
| 返回指向序列逆向起始的逆向迭代器 (公开成员函数) | |
| 返回指向序列逆向末尾的逆向迭代器 (公开成员函数) | |
元素访问 | |
| 访问第一个元素 (公开成员函数) | |
| 访问最后一个元素 (公开成员函数) | |
| 访问序列的元素 (公开成员函数) | |
| 返回指向元素序列起始的指针 (公开成员函数) | |
观察器 | |
| 返回序列中的元素数 (公开成员函数) | |
| 返回以字节表示的序列大小 (公开成员函数) | |
| 检查序列是否为空 (公开成员函数) | |
子视图 | |
| 获得由序列首 N 个元素组成的子段 (公开成员函数) | |
| 获得由序列末 N 个元素组成的子段 (公开成员函数) | |
| 获得子段 (公开成员函数) | |
[编辑] 非成员函数
返回指向 span 开始和结尾的迭代器 (函数) | |
转换 span 为对其底层字节的视图 (函数模板) | |
访问静态长度 span 的单个元素 (函数模板) |
[编辑] 非成员常量
| (C++20) |
size_t 类型常量，指明 span 拥有动态长度 (常量) |
[编辑] 辅助类
获得静态长度 span 的大小 (类模板特化) | |
获得静态长度 span 的元素类型 (类模板特化) |
