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

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

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

first に、長さ (last -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 より大きい場合は正の整数を、等しい場合はゼロを返す。

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
    });
}