QUtf8StringView Class

    void myfun1(QUtf8StringView sv);        // preferred
    void myfun2(const QUtf8StringView &sv); // compiles and works, but slower

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

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

ヌル文字列ビューを作成します。

isNull()も参照してください 。

[constexpr noexcept] template <typename Char, size_t N> QUtf8StringView::QUtf8StringView(const Char (&string)[N])

文字列リテラル `string` に基づいて文字列ビューを構築します。このビューは、最初の `Char(0) ` または `N` のいずれか早い方が検出されるまで、配列をカバーします。配列全体が必要な場合は、代わりに `fromArray()` を使用してください。

string この文字列ビューオブジェクトの存続期間中、常に有効な状態を維持する必要があります。

制約

string が実際の配列であり、かつChar が互換性のある文字型である場合にのみ、オーバーロード解決の対象となります。互換性のある文字型は、char8_t 、char 、signed char 、およびunsigned char です。

fromArray()も参照してください 。

[constexpr noexcept] template <typename Char> QUtf8StringView::QUtf8StringView(const Char *str)

str 上に文字列ビューを構築します。長さは、最初のChar(0) が検出されるまでスキャンすることで決定されます。

str この文字列ビューオブジェクトの存続期間中、有効であり続ける必要があります。

`nullptr `を`str `として渡しても安全であり、その結果、空の文字列ビューが生成されます。

制約

str が配列ではなく、かつChar が互換性のある文字型である場合にのみ、オーバーロードの解決に参加します。互換性のある文字型は、char8_t 、char 、signed char 、およびunsigned char です。

[constexpr noexcept] template <typename Container> requires if_compatible_container<Container> QUtf8StringView::QUtf8StringView(const Container &str)

str 上に文字列ビューを構築します。長さはstd::size(str) から取得されます。

std::data(str) この文字列ビューオブジェクトの存続期間中、有効であり続けなければならない。

std::size(str) == 0 の場合に限り、文字列ビューは空になります。このコンストラクタがヌル文字列ビューを生成する可能性があるかどうかは未定義です（その場合、std::data(str) はnullptr を返す必要があります）。

制約

Container がvalue_type と互換性のある文字型を持つコンテナである場合にのみ、オーバーロード解決の対象となります。互換性のある文字型は、char8_t 、char 、signed char 、およびunsigned char です。

isNull() およびisEmpty()も参照してください 。

[constexpr noexcept] QUtf8StringView::QUtf8StringView(std::nullptr_t)

ヌル文字列ビューを構築します。

isNull()も参照してください 。

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *first, const Char *last)

first 上で、長さが (last -first) の文字列ビューを構築します。

[first,last) の範囲は、この文字列ビューオブジェクトの存続期間中、有効なままである必要があります。

last がnullptr である場合、\nullptr をfirst として渡すことは安全であり、その結果、空の文字列ビューが生成されます。

last がfirst より前にある場合、またはfirst がnullptr であるのに対し、last がそうでない場合、その挙動は未定義となります。

制約

Char が互換性のある文字型である場合にのみ、オーバーロード解決の対象となります。互換性のある文字型は、char8_t 、char 、signed char 、およびunsigned char です。

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *str, qsizetype len)

str 上に、長さがlen の文字列ビューを作成します。

[str,len) の範囲は、この文字列ビューオブジェクトの存続期間中、有効なままである必要があります。

len も0である場合、nullptr をstr として渡すことは安全であり、その結果、nullの文字列ビューが生成されます。

len が負の値である場合、または正の値である場合にstr がnullptr である場合、その挙動は未定義となります。

制約

Char が互換性のある文字型である場合にのみ、オーバーロード解決の対象となる。互換性のある文字型は、char8_t 、char 、signed char 、およびunsigned char である。

[since 6.9] template <typename... Args> QString QUtf8StringView::arg(Args &&... args) const

この文字列中の「%N 」を、「args 」の対応する引数に置き換えます。引数は位置指定ではありません。args の最初の引数は、%N を最も低いN （すべて）に置き換え、args の2番目の引数は、%N を次に低いN に置き換える、というように続きます。

Args QAnyStringView へ暗黙的に変換可能なものであれば、どのようなものでも構成可能です。

この関数は Qt 6.9 で導入されました。

QString::arg(Args&&...)も参照してください 。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::at(qsizetype n) const

この文字列ビューのn の位置にあるコードポイントを返します。

n が負の数である場合、またはsize() 以上でない場合、挙動は未定義となります。

operator[]()、front() およびback()も参照してください 。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::back() const

文字列ビューの最後のコードポイントを返します。last() と同じ動作をします。

この関数は、STLとの互換性を確保するために提供されています。

front()も参照してください 。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::begin() const

文字列ビューの最初のコードポイントを指す、STL スタイルのconstイテレータを返します。

この関数は、STLとの互換性を確保するために提供されています。

end()、cbegin()、rbegin()、およびdata()も参照してください 。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::cbegin() const

begin() と同じです。

この関数は、STLとの互換性を確保するために提供されています。

cend()、begin()、crbegin()、およびdata()も参照してください 。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::cend() const

end() と同じです。

この関数は、STLとの互換性を確保するために提供されています。

cbegin()、end()、およびcrend()も参照してください 。

[constexpr] void QUtf8StringView::chop(qsizetype n)

この文字列ビューをn コードポイント分切り詰めます。

*this = first(size() - n) と同じ動作をします。

関連項目： sliced()、first()、last()、chopped()、およびtruncate()。

[constexpr] QUtf8StringView QUtf8StringView::chopped(qsizetype n) const

このオブジェクトの先頭から、size() -n の範囲の部分文字列を返します。

first(size() - n) と同じです。

関連項目： sliced()、first()、last()、chop()、truncate()、およびslice()。

この文字列ビューとstr を比較し、この文字列ビューがstr より小さい場合は負の整数を、str より大きい場合は正の整数を、等しい場合は0を返します。

cs がQt::CaseSensitive （デフォルト）の場合、比較は大文字と小文字を区別します。それ以外の場合は、大文字と小文字を区別しません。

これらの関数は Qt 6.5 で導入されました。

[noexcept] QUtf8StringView::const_reverse_iterator QUtf8StringView::crbegin() const

rbegin() と同じです。

この関数は、STLとの互換性を確保するために提供されています。

crend()、rbegin()、およびcbegin()も参照してください 。

[noexcept] QUtf8StringView::const_reverse_iterator QUtf8StringView::crend() const

rend() と同じです。

この関数は、STLとの互換性を確保するために提供されています。

crbegin()、rend()、およびcend()も参照してください 。

[constexpr noexcept] QUtf8StringView::const_pointer QUtf8StringView::data() const

文字列ビューの最初のコードポイントへのconstポインタを返します。

関連項目： begin()、end()、およびutf8()。

[constexpr noexcept] bool QUtf8StringView::empty() const

この文字列ビューが空であるかどうか、つまりsize() == 0 であるかどうかを返します。

この関数は、STLとの互換性を確保するために提供されています。

isEmpty()、isNull()、size()、およびlength()も参照してください 。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::end() const

リスト内の最後のコードポイントの直後に位置する仮想のコードポイントを指す、STL スタイルのconstイテレータを返します。

この関数は、STLとの互換性を確保するために提供されています。

begin()、cend()、およびrend()も参照してください 。

[constexpr] QUtf8StringView QUtf8StringView::first(qsizetype n) const

この文字列ビューの最初のn 個のコードポイントを含む文字列ビューを返します。

関連項目： last()、sliced()、chopped()、chop()、truncate()、およびslice()。

[static constexpr noexcept] template <typename Char, size_t Size> requires if_compatible_char<Char> QUtf8StringView QUtf8StringView::fromArray(const Char (&string)[Size])

Size 個の要素からなる完全な文字列リテラル `string ` に対して、末尾の `Char(0)` を含めて文字列ビューを構築します。ビューにヌル終端文字を含めたくない場合は、それが末尾にあると確実な時点で `chop()` を実行して除外することができます。 あるいは、配列リテラルを受け取るコンストラクタのオーバーロードを使用することもできます。これにより、データ内の最初のヌル終端文字まで（ただし、それ自体は含まない）のビューが作成されます。

string この文字列ビューオブジェクトの存続期間中、有効なままである必要があります。

Char が互換性のある文字型であれば、この関数はどの配列リテラルでも動作します。互換性のある文字型は、char8_t 、char 、signed char 、unsigned char です。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::front() const

文字列ビューの最初のコードポイントを返します。first() と同じ動作をします。

この関数は、STLとの互換性を確保するために提供されています。

back()も参照してください 。

[constexpr noexcept] bool QUtf8StringView::isEmpty() const

この文字列ビューが空であるかどうか、つまりsize() == 0 であるかどうかを返します。

この関数は、他の Qt コンテナとの互換性を確保するために提供されています。

empty()、isNull()、size()、およびlength()も参照してください 。

[constexpr noexcept] bool QUtf8StringView::isNull() const

この文字列ビューがnullであるかどうか、つまりdata() == nullptr であるかどうかを返します。

この関数は、他のQtコンテナとの互換性を確保するために提供されています。

empty()、isEmpty()、size()、およびlength()も参照してください 。

[noexcept, since 6.3] bool QUtf8StringView::isValidUtf8() const

この文字列に有効なUTF-8エンコードデータが含まれている場合はtrue を返し、そうでない場合はfalse を返します。

この関数は Qt 6.3 で導入されました。

[constexpr] QUtf8StringView QUtf8StringView::last(qsizetype n) const

この文字列ビューの最後のn 個のコードポイントを含む文字列ビューを返します。

関連項目: first()、sliced()、chopped()、chop()、truncate()、およびslice()。

[constexpr noexcept] qsizetype QUtf8StringView::length() const

size() と同じです。

この関数は、他の Qt コンテナとの互換性を確保するために提供されています。

empty()、isEmpty()、isNull()、およびsize()も参照してください 。

[static constexpr noexcept, since 6.8] qsizetype QUtf8StringView::maxSize()

この関数は、ビューが理論上表現可能な要素の最大数を返します。実際には、システムで利用可能なメモリ量によって制限されるため、その数ははるかに少なくなる場合があります。

この関数は Qt 6.8 で導入されました。

[constexpr noexcept, since 6.8] qsizetype QUtf8StringView::max_size() const

この関数は、STLとの互換性を確保するために提供されています。

maxSize() を返します。

この関数は Qt 6.8 で導入されました。

[noexcept] QUtf8StringView::const_reverse_iterator QUtf8StringView::rbegin() const

文字列ビュー内の最初のコードポイントを逆順で指す、STL 形式のconst 逆イテレータを返します。

この関数は、STLとの互換性を確保するために提供されています。

rend()、crbegin()、およびbegin()も参照してください 。

[noexcept] QUtf8StringView::const_reverse_iterator QUtf8StringView::rend() const

文字列ビューの最後のコードポイントの1つ先を指す、STL形式の逆方向イテレータを、逆順で返します。

この関数は、STLとの互換性を確保するために提供されています。

rbegin()、crend()、およびend()も参照してください 。

[constexpr noexcept] qsizetype QUtf8StringView::size() const

この文字列ビューのサイズを、UTF-8 コードポイント単位で返します（つまり、この関数では、マルチバイトシーケンスは 1 つ以上としてカウントされます。これは、QString およびQStringView におけるサロゲートペアの扱いと同じです）。

empty()、isEmpty()、isNull()、およびlength()も参照してください 。

[constexpr, since 6.8] QUtf8StringView &QUtf8StringView::slice(qsizetype pos, qsizetype n)

この文字列ビューを、位置pos から開始し、n コードポイント分だけ延長するように変更します。

この関数は Qt 6.8 で導入されました。

sliced()、first()、last()、chopped()、chop()、およびtruncate()も参照してください 。

[constexpr, since 6.8] QUtf8StringView &QUtf8StringView::slice(qsizetype pos)

この文字列ビューを、位置pos から始まり、その終わりまで及ぶように変更します。

この関数は Qt 6.8 で導入されました。

関連項目： sliced()、first()、last()、chopped()、chop()、およびtruncate()。

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos) const

このオブジェクトのpos の位置から始まり、その末尾まで続く文字列ビューを返します。

関連項目： first()、last()、chopped()、chop()、truncate()、およびslice()。

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos, qsizetype n) const

この文字列ビューの、位置pos から始まる、n 個のコードポイントを含む文字列ビューを返します。

first()、last()、chopped()、chop()、truncate()、およびslice()も参照してください 。

QString QUtf8StringView::toString() const

この文字列ビューのデータのディープコピーを、QString として返します。

この文字列ビューがnullである場合に限り、戻り値はnullのQString となります。

[constexpr] void QUtf8StringView::truncate(qsizetype n)

この文字列ビューをn コードポイントに切り詰めます。

*this = first(n) と同じです。

関連項目： sliced()、first()、last()、chopped()、およびchop()。

[noexcept] const char8_t *QUtf8StringView::utf8() const

文字列ビュー内の最初のコードポイントへのconstポインタを返します。

結果はconst char8_t* として返されるため、この関数はC++20モードでコンパイルする場合にのみ利用可能です。

関連項目： begin()、end()、およびdata()。

[noexcept, since 6.7] QUtf8StringView::operator std::string_view() const

この `QUtf8StringView ` オブジェクトを `std::string_view ` オブジェクトに変換します。返されるビューは、このビューと同じデータポインタと長さを持つことになります。

この関数は Qt 6.7 で導入されました。

[noexcept, since 6.10] QUtf8StringView::operator std::u8string_view() const

この `QUtf8StringView ` オブジェクトを `std::u8string_view ` オブジェクトに変換します。返されるビューは、このビューと同じデータポインタと長さを持つことになります。

この関数は、C++20モードでコンパイルする場合にのみ利用可能です。

この関数は、Qt 6.10で導入されました。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::operator[](qsizetype n) const

この文字列ビューのn の位置にあるコードポイントを返します。

n が負の値である場合、またはsize() 以上でない場合、動作は未定義となります。

at()、front()、およびback()も参照してください 。