QUtf8StringView Class

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

メンバ関数ドキュメント

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

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

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

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

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

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

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

文字列リテラル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 は、この文字列ビューオブジェクトの有効期間中有効でなければなりません。

str としてnullptr を渡すと安全で、NULL 文字列ビューになります。

このコンストラクタは、str が配列でなく、Char が互換性のある文字型である場合にのみ、オーバーロード解決に参加する。互換性のある文字型はchar8_t char,signed char およびunsigned char です。

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

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

std::data(str) は、この文字列ビューオブジェクトの有効期間中有効でなければなりません。

このコンストラクタは、Container がvalue_type と互換性のある文字型を持つコンテナである場合にのみ、オーバーロード解決に参加します。互換性のある文字型は以下のとおりです：char8_t char 、signed char 、unsigned char です。

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

isNull() およびisEmpty()も参照 。

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

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

isNull() も参照 。

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

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

[first,last) の範囲は、この文字列ビュー・オブジェクトの有効期間中有効でなければなりません。

first として\nullptr を渡しても、last がnullptr の場合は安全であり、NULL 文字列ビューになります。

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

このコンストラクタは、Char が互換性のある文字型の場合にのみ、オーバーロード解決に参加します。互換性のある文字型は以下のとおりです：char8_t char 、signed char 、unsigned char 。

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

長さlen を持つstr の文字列ビューを構築する。

[str,len) の範囲は、この文字列ビューオブジェクトの有効期間中、有効であり続けなければならない。

str としてnullptr を渡しても、len が 0 であれば安全であり、NULL 文字列ビューになります。

len が負の場合、または正の場合、str がnullptr の場合の動作は未定義です。

このコンストラクタは、Char が互換性のある文字型の場合にのみ、オーバーロード解決に参加します。互換性のある文字型は以下のとおりです：char8_t char 、signed char 、unsigned char です。

[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

文字列ビューの最初のコードポイントを指す constSTL 形式のイテレータを返します。

この関数は、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()も参照のこと 。

[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

リスト内の最後のコード点の後の虚数コード点を指す constSTL スタイルのイテレータを返します。

この関数は 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, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView QUtf8StringView::fromArray(const Char (&)[Size] string)

末尾のChar(0) を含む、完全な文字列リテラルstring に対して文字列ビューを構築します。ヌル・ターミネータをビューに含めたくない場合は、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

文字列ビューの最初のコードポイントを逆順に指す constSTL スタイルの逆イテレータを返します。

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

rend(),crbegin(),begin()も参照してください 。

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

STL 形式の逆順イテレータは、文字列ビューの最後のコードポイントから逆順に 1 つ前のコードポイントを指します。

この関数は、STL との互換性のために用意されています。

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

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

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

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 の場合のみ、戻り値は NULLQString になります。

[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] std::basic_string_view<QUtf8StringView::storage_type> QUtf8StringView::operator std::basic_string_view<QUtf8StringView::storage_type>() const

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

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

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

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

n が負またはsize() より小さくない場合、動作は未定義です。

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