QAnyStringView Class

メンバ関数ドキュメント

[constexpr noexcept] QAnyStringView::QAnyStringView()

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

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

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

文字列リテラルstring の文字列ビューを構築します。ビューは、最初のChar(0) が現れるか、N が現れるか、どちらか早い方まで配列をカバーします。配列全体が必要な場合は、代わりに fromArray() を使用します。

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

このコンストラクタは、string が実際の配列であり、Char が互換性のある文字型である場合にのみ、オーバーロードの解決に参加します。

Compatible Character Typesも参照 。

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

str の文字列ビューを構築します。長さは、最初のChar(0) をスキャンして決定されます。

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

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

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

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

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

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

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

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

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

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

[noexcept] QAnyStringView::QAnyStringView(const QByteArray &str)

str の文字列ビューを構築します。str のデータは UTF-8 として解釈されます。

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

文字列ビューは、str.isNull() の場合のみ null になります。

[noexcept] QAnyStringView::QAnyStringView(const QString &str)

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

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

文字列ビューは、str.isNull() の場合のみ NULL になります。

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

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

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

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

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

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

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

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

このコンストラクタは、Char が互換性のある文字型である場合にのみ、オーバーロード解決に参加します。

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

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

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

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

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

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

このコンストラクタは、Char が互換性のある文字型である場合にのみ、オーバーロード解決に参加します。

isNull() およびCompatible Character Typesも参照 。

[constexpr] QChar QAnyStringView::back() const

文字列ビューの最後の文字を返します。

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

front() およびSizes and Sub-Stringsも参照してください 。

[constexpr, since 6.5] void QAnyStringView::chop(qsizetype n)

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

*this = first(size() - n) と同じ。

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

sliced(),first(),last(),chopped(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

[constexpr, since 6.5] QAnyStringView QAnyStringView::chopped(qsizetype n) const

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

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

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

sliced(),first(),last(),chop(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

[static noexcept] int QAnyStringView::compare(QAnyStringView lhs, QAnyStringView rhs, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

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

operator==(),operator<(),operator>()も参照 。

[constexpr noexcept] const void *QAnyStringView::data() const

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

size_bytes()も参照 。

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

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

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

isEmpty()、isNull()、size()も参照 。

[constexpr, since 6.5] QAnyStringView QAnyStringView::first(qsizetype n) const

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

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

last(),sliced(),chopped(),chop(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

[constexpr] QChar QAnyStringView::front() const

文字列ビューの最初の文字を返します。

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

back() およびSizes and Sub-Stringsも参照してください 。

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

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

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

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

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

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

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

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::last(qsizetype n) const

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

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

first(),sliced(),chopped(),chop(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

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

size() と同じ。

この関数は、他の Qt コンテナとの互換性のために用意されています。

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

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

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

文字列ビューが理論的に表現できる要素の最大数を返します。実際には、システムで利用可能なメモリ量によって制限されるため、もっと少ない数になる可能性があります。

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

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

この文字列ビューのサイズを、エンコーディングのコードポイントで返します。

empty(),isEmpty(),isNull(),size_bytes(),Sizes and Sub-Stringsも参照してください 。

[constexpr noexcept] qsizetype QAnyStringView::size_bytes() const

この文字列ビューのサイズを、コードポイントではなくバイト数で返します。

この関数は、data() と一緒に使用して、ハッシュ化やシリアライズを行うことができます。

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

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

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

この文字列ビューをpos の位置から開始するように変更し、n コード・ポイント用に拡張します。

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

sliced(),first(),last(),chopped(),chop(),truncate(),Sizes and Sub-Stringsも参照してください 。

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

これはオーバーロードされた関数です。

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

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

sliced(),first(),last(),chopped(),chop(),truncate(),Sizes and Sub-Stringsも参照してください 。

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos) const

このオブジェクトの位置pos を始点とし、その終点までの文字列ビューを返します。

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

first(),last(),chopped(),chop(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos, qsizetype n) const

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

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

first(),last(),chopped(),chop(),truncate(),slice(),Sizes and Sub-Stringsも参照してください 。

QString QAnyStringView::toString() const

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

この文字列ビューが NULL の場合のみ、戻り値は NULLQString となります。

[constexpr, since 6.5] void QAnyStringView::truncate(qsizetype n)

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

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

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

sliced(),first(),last(),chopped(),chop(),Sizes and Sub-Stringsも参照してください 。

[constexpr] template <typename Visitor> decltype(auto) QAnyStringView::visit(Visitor &&v) const

この文字列ビューが参照する文字列データのエンコーディングに応じて、QUtf8StringView 、QLatin1String 、QStringView のいずれかでv を呼び出します。

このように、QAnyStringView を取るほとんどの関数は、エンコードごとの関数に分岐します：

void processImpl(QLatin1String s) { ~~~ }
void processImpl(QUtf8StringView s) { ~~~ }
void processImpl(QStringView s) { ~~~ }

void process(QAnyStringView s)
{
    s.visit([](auto s) { processImpl(s); });
}

ここでは、QAnyStringView オブジェクトとラムダのパラメーターの両方に、s という同じ名前を再利用しています。これは慣用的なコードであり、visit()呼び出しを通じてオブジェクトの同一性を追跡するのに役立つ。

bool equal(QAnyStringView lhs, QAnyStringView rhs)
{
    // assuming operator==(QAnyStringView, QAnyStringView) didn't, yet, exist:
    return lhs.visit([rhs](auto lhs) {
        rhs.visit([lhs](auto rhs) {
            return lhs == rhs;
        });
    });
}

visit()では、すべてのラムダのインスタンスが同じ戻り値型を持つ必要があります。これらの型が異なると、たとえ共通の型があったとしてもコンパイル・エラーになります。これを解決するには、ラムダで戻り値の型を明示的に使用するか、return文でキャストを行う：

// wrong:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {   // ERROR: lambdas return different types
        return input.sliced(0, input.size() / 2);
    });
}
// correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) -> QAnyStringView { // OK, explicit return type
        return input.sliced(0, input.size() / 2);
    });
}
// also correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {
        return QAnyStringView(input.sliced(0, input.size() / 2)); // OK, cast to common type
    });
}