QSpan Class

成员函数文档

[implicit] QSpan::QSpan()

默认构造函数。

只有当E 为零（0）或std::dynamic_extent 时，才存在此构造函数。换言之：只有固定零大小的跨度或可变大小的跨度才可使用默认构造函数进行构造。

另请参阅 extent 和Variable-Size and Fixed-Size Spans 。

构建一个QSpan ，引用所提供spanother 中的数据。

约束

仅当

• N 或extent 中的任意一个是std::dynamic_extent 或extent == N
• 且S 或const S 与T 相同。

[constexpr] template <typename Range, QSpan<T, E>::if_compatible_range<Range> = true> QSpan::QSpan(Range &&r)

构建一个 QSpan，该对象引用所提供范围r 中的数据。

约束

仅当Range 为a compatible range 时，才参与重载解析。

构建一个QSpan ，该对象引用所提供数组arr 中的数据。

约束

仅当

• N 或extent 中的任意一个是std::dynamic_extent ，或者extent == N
• 且S 或const S 与T 相同。

[constexpr] QSpan::QSpan(std::initializer_list<QSpan<T, E>::value_type> il)

构建一个引用所提供初始化列表il 中数据的QSpan。

约束

仅当T 采用const 限定时，才参与重载解析。

另请参阅 Const and Mutable Spans 。

[constexpr] template <typename It, QSpan<T, E>::if_compatible_iterator<It> = true> QSpan::QSpan(It first, It last)

构建一个引用从first 开始、长度为(last -first)的数据的QSpan。

[first, last) 必须是一个有效的范围。

约束

仅当It 为a compatible iterator 时，才参与重载解析。

[constexpr] template <typename It, QSpan<T, E>::if_compatible_iterator<It> = true> QSpan::QSpan(It first, qsizetype count)

构建一个 QSpan，该 QSpan 引用从first 开始且长度为count 的数据。

[first, count) 必须是一个有效的范围。

约束

仅当It 为a compatible iterator 时，才参与重载解析。

[constexpr] auto QSpan::back() const

返回对该span中最后一个元素的引用。

该 span 不能为空，否则行为未定义。

另请参阅 operator[](),front(),size(),empty() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::begin() const

返回一个指向该范围起始位置的迭代器。

由于QSpan 的迭代器只是指针，因此这与调用data() 效果相同。

另请参阅 end()、cbegin()、rbegin()、crbegin()、data() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::cbegin() const

返回一个指向该片段起始位置的const_iterator 。

即使 `T ` 不是 `const`，此方法仍会返回一个只读迭代器：

QSpan<int> span = ~~~;
*span.begin() = 42; // OK
*span.cbegin() = 42; // ERROR: cannot assign through a const_iterator

另请参阅 cend()、begin()、crbegin()、rbegin()、data() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::cend() const

返回一个指向span结尾之后一个位置的const_iterator 。

另请参阅 cbegin()、end()、crend()、rend()、data()、size() 以及Const and Mutable Spans 。

[constexpr, since 6.9] void QSpan::chop(QSpan<T, E>::size_type n)

与*this = chopped( 、n 、) 相同。

此函数仅在variable-sized spans 上可用。

该函数自 Qt 6.9 起引入。

另请参阅 chopped()。

[constexpr, since 6.9] auto QSpan::chopped(QSpan<T, E>::size_type n) const

返回一个大小为size()的variable-sized 范围，其引用范围为n ，对应该范围内的前size()-n 个元素。

与first(size() - n) 相同。

n 必须为非负数。

该 span 必须至少包含n 个元素（E >=n 且 size() >=n ），否则行为未定义。

该函数在 Qt 6.9 中引入。

另请参阅 subspan()、first(QSpan<T,E>::size_type)、last(QSpan<T,E>::size_type) 以及chop()。

[constexpr noexcept] auto QSpan::crbegin() const

返回一个指向反向时间段起点的const_reverse_iterator 。

另请参阅 crend()、rbegin()、cbegin()、begin() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::crend() const

返回一个指向反向区间末尾之后一个位置的const_reverse_iterator 。

另请参阅 crbegin()、rend()、cend()、end() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::data() const

返回指向该范围起始位置的指针。

这与调用 `begin()` 相同。

另请参阅 begin()、front() 以及Const and Mutable Spans 。

返回该区间是否为空，即size() == 0 。

这两个函数的功能相同：empty() 用于兼容 STL，isEmpty() 用于兼容 Qt。

另请参阅 size() 和size_bytes()。

[constexpr noexcept] auto QSpan::end() const

返回一个指向该范围末尾之后一个位置的迭代器。

由于QSpan 迭代器只是指针，因此这与调用data() + size() 效果相同。

另请参阅 begin()、cend()、rend()、crend()、data()、size() 以及Const and Mutable Spans 。

[constexpr noexcept(...)] template <std::size_t Count> auto QSpan::first() const

返回一个大小为Count 的fixed-sized 跨度，该跨度引用*this 中前Count 个元素。

该 span 必须至少包含Count 个元素（E >=Count 且 size() >=Count ），否则行为未定义。

另请参阅 first(QSpan<T,E>::size_type)、last() 以及subspan()。

[constexpr] auto QSpan::first(QSpan<T, E>::size_type n) const

返回一个大小为n 的variable-sized 跨度，该跨度引用了*this 中前n 个元素。

n 必须为非负数。

该 span 必须至少包含n 个元素（E >=n 且 size() >=n ），否则行为未定义。

另请参阅 first<N>()、last(QSpan<T,E>::size_type)、subspan(QSpan<T,E>::size_type)、subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type)、sliced() 以及chopped()。

[constexpr] auto QSpan::front() const

返回对该 span 中第一个元素的引用。

span 不能为空，否则行为未定义。

另请参阅 operator[](),back(),size(),empty() 以及Const and Mutable Spans 。

[constexpr noexcept(...)] template <std::size_t Count> auto QSpan::last() const

返回一个大小为Count 的fixed-sized 跨度，该跨度引用了*this 中最后Count 个元素。

该 span 必须至少包含Count 个元素（E >=Count 且 size() >=Count ），否则行为未定义。

另请参阅 last(QSpan<T,E>::size_type)、first() 和subspan()。

[constexpr] auto QSpan::last(QSpan<T, E>::size_type n) const

返回一个大小为n 的variable-sized 跨度，该跨度引用了*this 中最后n 个元素。

n 必须为非负数。

该跨度必须至少包含n 个元素（E >=n 且 size() >=n ），否则行为未定义。

另请参阅 last()、first(QSpan<T,E>::size_type)、subspan(QSpan<T,E>::size_type)、subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type)、sliced() 以及chopped()。

[constexpr noexcept] auto QSpan::rbegin() const

返回一个指向反向时间段起点的reverse_iterator 对象。

另请参阅 rend()、crbegin()、begin()、cbegin() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::rend() const

返回一个指向反向区间末尾之后一个位置的reverse_iterator 。

另请参阅 rbegin()、crend()、end()、cend() 以及Const and Mutable Spans 。

[constexpr noexcept] auto QSpan::size() const

返回 span 的大小，即它所引用的元素数量。

另请参阅 size_bytes()、empty()、以及isEmpty()。

[constexpr noexcept] auto QSpan::size_bytes() const

返回该span的大小（以字节为单位），即元素数量乘以sizeof(T) 。

另请参阅 size()、empty() 和isEmpty()。

[constexpr, since 6.9] void QSpan::slice(QSpan<T, E>::size_type pos)

与*this = sliced( 、pos 、) 相同。

此函数仅在variable-sized spans 上可用。

该函数在 Qt 6.9 中引入。

另请参阅 sliced()。

[constexpr, since 6.9] void QSpan::slice(QSpan<T, E>::size_type pos, QSpan<T, E>::size_type n)

与*this = sliced( 、pos 、, 、n 、) 相同。

此函数仅在variable-sized spans 上可用。

该函数在 Qt 6.9 中引入。

另请参阅 sliced()。

返回一个大小为size() - pos 的variable-sized 跨度，该跨度引用了在删除前pos 个元素后剩余的部分。

pos 必须为非负数。

该 span 必须至少包含pos 个元素（E >=pos 且 size() >=pos ），否则行为未定义。

这些函数的功能相同：subspan() 用于兼容 STL，而sliced() 用于兼容 Qt。

另请参阅 subspan()、first(QSpan<T,E>::size_type)、last(QSpan<T,E>::size_type)、chopped() 以及slice()。

返回一个大小为n 的variable-sized 跨区，该跨区引用了从pos 开始的该跨区中的n 元素。

pos 和n 必须均为非负数。

该跨度必须至少包含pos + n 个元素（E >=pos + n 且 size() >=pos + n ），否则行为未定义。

这些函数功能相同：subspan() 用于兼容 STL，sliced() 用于兼容 Qt。

另请参阅 subspan()、first(QSpan<T,E>::size_type)、last(QSpan<T,E>::size_type)、chopped() 以及slice()。

[constexpr noexcept(...)] template <std::size_t Offset, std::size_t Count> auto QSpan::subspan() const

返回一个大小为Count 的span，该span引用了从Offset 开始的、属于该span的Count 个元素。

如果*this 是可变大小的 span，则返回类型为可变大小的 span；否则，返回类型为固定大小的 span。

该 span 必须至少容纳Offset + Count 个元素（E >=Offset + Count 且 size() >=Offset + Count ），否则行为未定义。

另请参阅 subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type)、first()、last() 以及Variable-Size and Fixed-Size Spans 。

[constexpr noexcept(...)] template <std::size_t Offset> auto QSpan::subspan() const

返回一个大小为E - Offset 的span，该span引用了在删除前Offset 个元素后剩余的部分。

如果*this 是可变大小的 span，则返回类型为可变大小的 span；否则，返回类型为固定大小的 span。

该 span 必须至少包含Offset 个元素（E >=Offset 且 size() >=Offset ），否则行为未定义。

另请参阅 subspan(QSpan<T,E>::size_type)、subspan()、first()、last() 以及Variable-Size and Fixed-Size Spans 。

这些特殊成员函数是隐式定义的。

[constexpr] QSpan<T, E>::reference QSpan::operator[](QSpan<T, E>::size_type idx) const

返回 span 标签中索引为idx 的元素的引用。

索引必须在有效范围内，即idx >= 0 且idx <size()，否则行为未定义。

另请参阅 front()、back()、size()、empty() 以及Const and Mutable Spans 。