QAnyStringView Class

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

[constexpr noexcept] QAnyStringView::QAnyStringView()

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

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

[constexpr noexcept] template <typename Char> requires if_compatible_char<Char> QAnyStringView::QAnyStringView(const Char &ch)

単一の文字ch に基づいて文字列ビューを構築します。長さは通常、1 です（ただし、以下を参照してください）。

一般的に、この方法で作成された QAnyStringView は、式全体が終了し、一時変数が破棄された時点で、古いデータを参照し始めるものと見なす必要があります。 つまり、QAnyStringViewを受け取る関数に単一の文字を渡すためにこれを使用することは、問題なく安全です（その関数のドキュメントで、最初の呼び出しよりも長いライフタイムが要求されていない限り）：

int to_int(QAnyStringView);
int res = to_int(u'9'); // OK, data stays around for the duration of the call

しかし、オブジェクトをより長く保持し続けることは未定義の挙動となります：

QAnyStringView ch = u'9';
int res = to_int(ch); // (silent) ERROR: ch references deleted data

これが必要な場合は、

const auto nine = u'9';
QAnyStringView ch(nine); // ok, references `nine`, which outlives `ch`
int res = to_int(ch); // 9

上記は、直接サポートされているすべてのCompatible Character Types 型に当てはまります。

ch がこれらの型のいずれかではなく、単にQChar に変換される場合（例：QChar::SpecialCharacter やQLatin1Char など）、QAnyStringViewは、2番目の例と同様に、式全体の終了時に削除される一時オブジェクトにバインドされます。

ch が単一のUTF-16コードユニットで表現できない場合（例えば、char32_t 値である場合など）、このコンストラクタはch を2つのUTF-16コードユニットに分解します。 その場合、結果の QAnyStringView の `size()` の値は `2 ` となり、分解結果が格納された一時バッファは、

[](char32_t ch, auto &&tmp = QChar::fromUcs4(ch)) {
    return QAnyStringView(tmp);
}

この場合の同等の安全なバージョンは次のようになります。

const auto decomposed = QChar::fromUcs4(ch);
QAnyStringView ch(decomposed);

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

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

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

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

制約

str が配列ではなく、Char が互換性のある文字型である場合にのみ、オーバーロードの解決に関与します。

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

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

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

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

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

制約

Container がvalue_type と同等の文字型を持つコンテナである場合にのみ、オーバーロードの解決に関与します。

関連項目： 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)

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

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

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

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

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

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

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

制約

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

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

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

str 上に、長さlen の文字列ビューを構築します。

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

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

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

制約

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

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

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

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

Args QAnyStringView に暗黙的に変換可能な任意の型で構成されます。

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

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

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

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

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

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

Char が互換性のある文字型であれば、この関数はどの配列リテラルでも動作します。互換性のある文字型は、QChar 、ushort 、char16_t 、および（Windowsなどの16ビット型であるプラットフォームでは）wchar_t です。

[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である場合に限り、戻り値はnullのQString となります。

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