QSpan Class

メンバ関数ドキュメント

これらの特殊メンバ関数は暗黙的に定義されています。

与えられた配列arr のデータを参照するQSpan を構築する。

• N またはextent のいずれかがstd::dynamic_extent であるか、そうでなければextent == である場合。N
• であり、S またはconst S がT と同じである場合にのみ、オーバーロード解決に参加します。

与えられたスパンother のデータを参照するQSpan を構築します。

• N またはextent のいずれかがstd::dynamic_extent またはextent == である場合。N
• であり、S またはconst S のいずれかがT と同じである場合にのみ、オーバーロード解決に参加します。

スパンが空かどうか、つまりsize() == 0 かどうかを返します。

empty() は STL との互換性のために、isEmpty() は Qt との互換性のために用意されています。

size() およびsize_bytes()も参照してください 。

最初のpos 要素を取り除いた後のこのスパンの余りを参照する、サイズsize() - pos の可変サイズのスパンを返します。

pos は非負でなければなりません。

このスパンは、少なくともpos 要素 (E >=pos および size() >=pos) を保持しなければならない。

subspan() は STL との互換性のために、sliced() は Qt との互換性のために用意されています。

subspan(),first(QSpan<T,E>::size_type),last(QSpan<T,E>::size_type)も参照してください 。

pos から始まるこのスパンのn 要素を参照する、サイズ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)も参照してください 。

[default] QSpan::QSpan()

デフォルトコンストラクタ。

このコンストラクタは、E がゼロ(0)か、std::dynamic_extent の場合のみ存在します。 言い換えれば、固定ゼロサイズか可変サイズのスパンのみがデフォルトコンストラクタ可能です。

extentも参照してください 。

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

与えられた範囲r のデータを参照する QSpan を構築します。

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

与えられたイニシャライザリストil のデータを参照するQSpanを構築します。

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

first から始まり、長さ (last -first) を持つデータを参照する QSpan を構築します。

[first, last) は有効な範囲でなければなりません。

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

first で始まり、長さcount を持つデータを参照する QSpan を構築します。

[first, count) は有効な範囲でなければなりません。

[constexpr] auto QSpan::back() const

スパン内の最後の要素への参照を返します。

span は空であってはならず、そうでない場合の動作は未定義です。

operator[]()、front()、size()、empty()も参照 。

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

span の先頭を指すイテレータを返します。

QSpan イテレータは単なるポインタなので、これはdata() を呼び出すのと同じです。

end()、cbegin()、rbegin()、crbegin()、data()も参照 。

[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()も参照のこと 。

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

スパンの末尾からひとつ先を指すconst_iterator を返す。

cbegin()、end()、crend()、rend()、data()、size() も参照の こと。

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

反転したスパンの先頭を指すconst_reverse_iterator を返す。

crend()、rbegin()、cbegin()、begin()も参照のこと 。

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

const_reverse_iterator は、反転したスパンの末尾を指す。

crbegin()、rend()、cend()、end()も参照の こと。

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

スパンの先頭へのポインタを返す。

begin() を呼び出すのと同じ。

begin() およびfront()も参照 。

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

スパンの終端のひとつ先を指すイテレータを返します。

QSpan イテレータは単なるポインタなので、これはdata() + size() を呼び出すのと同じである。

begin()、cend()、rend()、crend()、data()、size()も参照 。

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

*this の最初のCount 要素を参照する、サイズ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

*this の最初のn 要素を参照するサイズ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()も参照 。

[constexpr] auto QSpan::front() const

スパン内の最初の要素への参照を返します。

スパンは空であってはならず、そうでない場合の動作は未定義です。

operator[]()、back()、size()、empty()も参照 。

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

*this の最後のCount 要素を参照する、サイズ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

*this の最後のn 要素を参照するサイズn の可変サイズのスパンを返す。

n は非負でなければならない。

spanは、少なくとも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()も参照 。

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

反転されたスパンの先頭を指すreverse_iterator を返します。

rend()、crbegin()、begin()、cbegin()も参照 。

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

reverse_iterator は、反転したスパンの末尾を指す。

rbegin()、crend()、end()、cend()も参照 。

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

span のサイズ、つまり参照している要素の数を返します。

size_bytes()、empty()、isEmpty() も参照 。

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

スパンのサイズをバイト単位、つまり要素数にsizeof(T) を掛けた値で返す。

size()、empty()、およびisEmpty() も参照 。

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

Offset から始まるこのスパンのCount 要素を参照する、サイズCount のスパンを返す。

*this が可変サイズのスパンである場合、戻り値の型は可変サイズのスパンであり、そうでない場合は固定サイズのスパンである。

このスパンは、少なくともOffset + Count 要素（E >=Offset + Count かつ size() >=Offset + Count ）を保持しなければならず、そうでない場合の動作は未定義である。

subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), subspan(),first(),last()も参照 。

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

最初のOffset 要素を取り除いた後のこのスパンの残りを参照する、サイズE - Offset のスパンを返す。

*this が可変サイズのスパンである場合、戻り値の型は可変サイズのスパンであり、そうでない場合は固定サイズのスパンである。

このスパンは、少なくともOffset 要素（E >=Offset と size() >=Offset ）を保持しなければならない。そうでない場合の動作は未定義である。

subspan(QSpan<T,E>::size_type),subspan(),first(),last()も参照 。

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

スパンのインデックスidx にある要素への参照を返します。

インデックスが範囲内になければならない、つまり、idx >= 0かつidx <size()でなければならない。そうでない場合の動作は未定義である。

front(),back(),size(),empty()も参照のこと 。