QSpan Class

メンバ関数のドキュメント

[implicit] QSpan::QSpan()

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

このコンストラクタは、E がゼロ (0) またはstd::dynamic_extent のいずれかである場合にのみ存在します。つまり、固定サイズ（0）または可変サイズのスパンのみがデフォルトで生成可能です。

extent およびVariable-Size and Fixed-Size Spansも参照してください 。

指定されたspanother 内のデータを参照するQSpan を構築します。

制約

以下のいずれかの場合にのみ、オーバーロード解決の対象となります。

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

指定された範囲r 内のデータを参照するQSpanを生成します。

制約

Range がa compatible range である場合にのみ、オーバーロード解決の対象となります。

指定された配列 `arr` 内のデータを参照する `QSpan ` を生成します。

制約

xml-ph-0000@deepl.internal または xml-ph-0001@deepl.internal のいずれかが

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

first から始まる、長さがcount のデータを参照する QSpan を生成します。

[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

スパン（span）の先頭を指す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）の末尾の1つ先を指す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 は非負でなければなりません。

このスパンには、少なくとも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

逆順にした範囲の末尾の1つ先を指す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

スパン（span）の末尾の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 スパンを返します。

このスパンには、少なくとも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()、および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

*this の最後のCount 個の要素を参照する、サイズがCount のfixed-sized スパンを返します。

このスパンには、少なくとも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()、およびchopped()も参照してください。

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

逆順になったスパンのはじまりを指すreverse_iterator を返します。

rend()、crbegin()、begin()、cbegin()、およびConst and Mutable Spansも参照してください 。

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

逆順のスパン範囲の末尾から1つ先の位置を指す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, 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()も参照してください 。

最初の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)、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

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

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

このスパンには、少なくとも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

最初の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

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

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

front()、back()、size()、empty() およびConst and Mutable Spansも参照してください 。