QSpan Class

成员函数文档

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

构造一个QSpan ，引用所提供数组arr 中的数据。

限制条件

只有当

• N 或extent 是std::dynamic_extent ，否则extent == N
• 且S 或const S 与T 相同。

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

限制条件

只有当

• N 或extent 是std::dynamic_extent 或extent == N
• 且S 或const S 与T 相同时，才会参与重载解析。

返回 span 是否为空，即size() == 0 是否为空。

这些函数做同样的事情：提供empty() 是为了与 STL 兼容，提供isEmpty() 是为了与 Qt XML 兼容。

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

返回variable-sized span，大小为size() - pos ，引用去掉第一个pos 元素后此 span 的剩余部分。

pos 必须是非负数。

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

这些函数的作用相同：subspan() 是为了与 STL 兼容，而sliced() 是为了与 Qt XML 兼容。

另请参阅 subspan(),first(QSpan<T,E>::size_type),last(QSpan<T,E>::size_type),chopped(), 和slice().

返回大小为variable-sized 的跨度n ，从pos 开始引用该跨度的n 元素。

pos 和n 都必须是非负数。

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

这些函数的作用相同：subspan() 是为了与 STL 兼容，而sliced() 是为了与 Qt XML 兼容。

另请参阅 subspan(),first(QSpan<T,E>::size_type),last(QSpan<T,E>::size_type),chopped(), 和slice().

[default] QSpan::QSpan()

默认构造函数。

只有当E 为 0 (0) 或std::dynamic_extent 时，才会出现该构造函数。换句话说：只有固定零大小或可变大小的跨度才可使用默认构造函数。

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

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

构造一个 QSpan，引用所提供范围r 中的数据。

限制条件

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

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

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

限制条件

只有当T 是const 合格时，才参与重载解析。

另请参阅 Const and Mutable Spans 。

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

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

[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，引用从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

返回一个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

返回大小为variable-sized 的跨距size() -n ，引用此跨距的第一个size() -n 元素。

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

n 必须为非负。

此跨度必须至少包含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 。

[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

返回fixed-sized span，大小为Count ，引用*this 的第一个Count 元素。

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

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

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

返回variable-sized span，大小为n ，引用*this 的第一个n 元素。

n 必须为非负。

跨度必须至少包含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

返回fixed-sized span，大小为Count ，引用*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

返回variable-sized span，大小为n ，引用*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

返回跨度的大小，即引用元素的个数。

另请参见 size_bytes()、empty() 和isEmpty()。

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

以字节为单位返回跨度的大小，即元素数乘以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() 。

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

返回大小为Count 的跨度，引用该跨度中从Offset 开始的Count 元素。

如果*this 是一个大小可变的跨度，则返回类型是一个大小可变的跨度，否则是一个大小固定的跨度。

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

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

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

返回大小为E - Offset 的跨度，引用去掉第一个Offset 元素后此跨度的剩余部分。

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

此跨度必须至少包含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

返回对跨中索引idx 处元素的引用。

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

另请参阅 front(),back(),size(),empty() 和Const and Mutable Spans 。