QSpan Class

メンバ関数ドキュメント

これらの特別メンバー関数は暗黙的に定義される。

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

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

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

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

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

これらの関数は同じことを行います。empty() は STL との互換性のために提供され、isEmpty() は Qt との互換性のために提供されます。

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

最初のpos 要素を取り除いた後の、このスパンの残りを参照する、サイズsize() - pos のvariable-sized スパンを返す。

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 のvariable-sized スパンを返す。

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 およびVariable-Size and Fixed-Size Spansも参照してください 。

[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を構築する。

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) は有効な範囲でなければなりません。

[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 内の最後の要素への参照を返します。

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 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

スパンの終端から1つ先を指すイテレータを返す。

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

begin()、cend()、rend()、crend()、data()、size()、Const and Mutable Spansも参照のこと 。

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

*this の最初のCount 要素を参照する、サイズCount のfixed-sized 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 のvariable-sized スパンを返す。

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()も参照 。

[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

*this の最後のCount 要素を参照する、サイズCount のfixed-sized 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 のvariable-sized スパンを返す。

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()も参照 。

[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

スパンのサイズをバイト単位で、つまり要素数に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(),Variable-Size and Fixed-Size Spansも参照 。

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