std::span

来自cppreference.com
< cpp‎ | container
定义于头文件 <span>
template<

    class T,
    std::ptrdiff_t Extent = std::dynamic_extent

> class span;
(C++20 起)

类模板 span 所描述的对象能指代对象的相接序列,序列的首元素在零位置。 span 能拥有静态长度,该情况下序列中的元素数已知并编码于类型中,或拥有动态长度。

典型实现只保有二个成员:指向 T 的指针和大小。

目录

[编辑] 模板形参

T - 元素类型;必须是完整类型且非抽象类
Extent - 序列中的元素数,或若它为动态则为 std::dynamic_extent ;若 Extent 为负且非 std::dynamic_extent 则程序为病式

[编辑] 成员类型

 
成员类型 定义
element_type T
value_type std::remove_cv_t<T>
index_type std::ptrdiff_t
difference_type std::ptrdiff_t
pointer T*
reference T&
iterator 实现定义的随机访问迭代器 (RandomAccessIterator) 、常表达式迭代器 (ConstexprIterator) 兼相接迭代器 (ContiguousIterator) ,其 value_typevalue_type
const_iterator 实现定义的常随机访问迭代器 (RandomAccessIterator) 、常表达式迭代器 (ConstexprIterator) 兼相接迭代器 (ContiguousIterator) ,其 value_typevalue_type
reverse_iterator std::reverse_iterator<iterator>
const_reverse_iterator std::reverse_iterator<const_iterator>

注意:若 T 无 const 限定则 iterator 为可变迭代器。

容器 (Container) 的迭代器类型上的所有要求亦应用于 spaniteratorconst_iterator 类型。

[编辑] 成员常量

static constexpr std::ptrdiff_t extent = Extent;

[编辑] 成员函数

构造 span
(公开成员函数) [编辑]
赋值 span
(公开成员函数) [编辑]
迭代器
返回指向序列起始的迭代器
(公开成员函数) [编辑]
返回指向序列末尾的迭代器
(公开成员函数) [编辑]
返回指向序列逆向起始的逆向迭代器
(公开成员函数) [编辑]
返回指向序列逆向末尾的逆向迭代器
(公开成员函数) [编辑]
元素访问
访问序列的元素
(公开成员函数) [编辑]
返回指向元素序列起始的指针
(公开成员函数) [编辑]
观察器
返回序列中的元素数
(公开成员函数) [编辑]
返回以字节表示的序列大小
(公开成员函数) [编辑]
检查序列是否为空
(公开成员函数) [编辑]
子视图
获得由序列首 N 个元素组成的子段
(公开成员函数) [编辑]
获得由序列末 N 个元素组成的子段
(公开成员函数) [编辑]
获得子段
(公开成员函数) [编辑]

[编辑] 非成员函数

比较二个 span 的元素
(函数模板) [编辑]
转换 span 为对其底层字节的视图
(函数模板) [编辑]

[编辑] 非成员常量

ptrdiff_t 类型常量
(常量) [编辑]

[编辑] 推导指引