QUtf8StringView Class

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

メンバ関数ドキュメント

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

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

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

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

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

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

リストの最後のコードポイントの後の虚数コードポイントを指す、STLスタイルのイテレータを返します。

この関数は 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)

文字列リテラル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

文字列ビューの最初のコードポイントを指す 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 コードポイント単位で返します (つまり、この関数ではマルチバイトのシーケンスは 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である場合に限り、戻り値は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()も参照 。