QString Class

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

文字列の左端の文字n を含む部分文字列を返す。

n が範囲外であってはならないことが分かっている場合、新しいコードではfirst() を代わりに使用する。

n がsize() より大きいか等しいか、ゼロより小さい場合は、文字列全体が返される。

first()、last()、startsWith()、chopped()、chop()、truncate()も参照のこと 。

文字列の右端の文字n を含む部分文字列を返す。

n が範囲外であってはならないことが分かっている場合、新しいコードではlast() を代わりに使用する。

n がsize() より大きいか等しいか、ゼロより小さい場合は、文字列全体が返される。

endsWith()、last()、first()、sliced()、chopped()、chop()、truncate()、slice()も参照の こと。

指定されたposition インデックスから始まる、この文字列のn 文字を含む文字列を返す。

position とn が範囲外であってはならないことが分かっている場合、新しいコードではsliced() を代わりに使うと高速になる。

position インデックスが文字列の長さを超える場合は、ヌル文字列を返す。指定されたposition から始まる文字列で使用可能な文字がn 未満の場合、またはn が -1 の場合（デフォルト）、この関数は、指定されたposition から使用可能なすべての文字を返します。

first()、last()、sliced()、chopped()、chop()、truncate()、slice()も参照のこと 。

この文字列の最初のn 文字を含む文字列を返す。

QString x = "Pineapple";
QString y = x.first(4);      // y == "Pine"

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

last(),sliced(),startsWith(),chopped(),chop(),truncate(),slice()も参照してください 。

この文字列の最後のn 文字を含む文字列を返す。

QString x = "Pineapple";
QString y = x.last(5);      // y == "apple"

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

first()、sliced()、endsWith()、chopped()、chop()、truncate()、slice()も参照してください 。

pos の位置から始まる、この文字列のn 文字を含む文字列を返す。

QString x = "Nine pineapples";
QString y = x.sliced(5, 4);            // y == "pine"
QString z = x.sliced(5);               // z == "pineapples"

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

first(),last(),chopped(),chop(),truncate(),slice()も参照してください 。

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

この文字列の位置pos から始まり、その終わりまでの部分を含む文字列を返す。

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

first(),last(),chopped(),chop(),truncate(),slice()も参照してください 。

この文字列のsize() -len 左端の文字を含む文字列を返す。

endsWith()、first()、last()、sliced()、chop()、truncate()、slice()も参照 。

これは、文字列が理論的に保持できる要素の最大数を返す。実際には、システムで利用可能なメモリ量によって制限されるため、この数はもっと小さくなります。

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

template <typename... Args> QString QString::arg(Args &&... args) const

この文字列内の%N の出現箇所を、args の対応する引数で置き換える。 引数は位置指定ではない。args の最初の引数は、%N を最も低いN （すべて）で置き換え、args の 2 番目の引数は、%N を次に低いN で置き換えるなど。

Args は、暗黙のうちに 、 、 に変換するものであれば何でも構わない。QString QStringView QLatin1StringView

さらに、以下の型もサポートされている：QChar QLatin1Char 。

QString::arg()も参照のこと 。

文字列を、sep が発生する箇所で部分文字列ビューに分割し、それらの文字列の遅延シーケンスを返します。

と同等です。

return QStringTokenizer{std::forward<Needle>(sep), flags...};

ただし、コンパイラで C++17 CTAD（Class Template Argument Deduction）が有効になっていなくても動作します。

sep とflags がどのように相互作用して結果を形成するかについては、QStringTokenizer を参照してください。

QStringTokenizer result = sv.tokenize(sep);

(と書くことができます（テンプレート引数なし）。C++17 CTAD を使用できない場合は、auto 変数にのみ戻り値を格納する必要があります：

auto result = sv.tokenize(sep);

これは、QStringTokenizer のテンプレート引数は、それが返される特定のtokenize() オーバーロードに非常に微妙に依存し、通常はセパレーターに使用される型に対応しないからです。

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

QStringTokenizer およびqTokenize()も参照のこと 。

[constexpr noexcept] QString::QString()

NULL文字列を作成します。NULL 文字列も空文字列とみなされます。

isEmpty()、isNull()、Distinction Between Null and Empty Stringsも参照 。

QString::QString(QChar ch)

文字ch を含むサイズ1の文字列を構築する。

QString::QString(QLatin1StringView str)

str が見ている Latin-1 文字列のコピーを構築する。

fromLatin1()も参照 。

QString::QString(const QByteArray &ba)

バイト配列ba で初期化された文字列を構築する。与えられたバイト配列はfromUtf8() を使って Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、このコンストラクタを無効にすることができます。これは、ユーザが表示できるすべての文字列がQObject::tr() を通過するようにしたい場合などに便利です。

fromLatin1(),fromLocal8Bit(),fromUtf8()も参照してください 。

QString::QString(const char *str)

8 ビット文字列str で初期化された文字列を構築します。与えられた const char ポインタはfromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、このコンストラクタを無効にすることができます。これは、例えば、ユーザから見える文字列がすべてQObject::tr() を通るようにしたい場合に便利です。

fromLatin1()、fromLocal8Bit()、fromUtf8()も参照のこと 。

[since 6.1] QString::QString(const char8_t *str)

UTF-8 文字列str で初期化された文字列を構築します。与えられた const char8_t ポインタはfromUtf8() 関数を使って Unicode に変換されます。

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

fromLatin1()、fromLocal8Bit()、fromUtf8()も参照してください 。

[explicit] QString::QString(const QChar *unicode, qsizetype size = -1)

QChar 配列unicode の最初の文字size で初期化された文字列を構築する。

unicode が 0 の場合、NULL 文字列が構築されます。

size が負の場合、unicode は'終端配列'を指すものと見なされ、その長さは動的に決定されます。終端のヌル文字は文字列の一部とは見なされません。

QStringは文字列データのディープコピーを作成します。ユニコード・データはそのままコピーされ、バイト・オーダー・マークがある場合は保持されます。

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

QString::QString(qsizetype size, QChar ch)

すべての文字がch に設定された、与えられたsize の文字列を構築する。

fill()も参照のこと 。

[noexcept] QString::QString(const QString &other)

other のコピーを構築する。

QStringは暗黙的に共有されるため、この操作には一定の時間がかかる。これにより、関数からQStringを返すのが非常に高速になります。共有インスタンスが変更された場合、それはコピーされ（コピーオンライト）、線形時間がかかります。

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

[noexcept] QString::QString(QString &&other)

Move-QStringインスタンスを構築し、other が指していたのと同じオブジェクトを指すようにする。

[noexcept] QString::~QString()

文字列を破壊する。

QString &QString::append(const QString &str)

この文字列の末尾に文字列str を追加する。

例

QString x = "free";
QString y = "dom";

x.append(y);
// x == "freedom"

これはinsert() 関数を使用するのと同じである：

x.insert(x.size(), y);

append()関数は通常、非常に高速（定数時間）である。これは、QString が文字列データの末尾に余分なスペースをあらかじめ割り当てているため、毎回文字列全体を再割り当てすることなくデータを増やすことができるからである。

operator+=()、prepend()、insert()も参照の こと。

QString &QString::append(QChar ch)

この関数は append() をオーバーロードする。

この文字列に文字ch を追加します。

QString &QString::append(QLatin1StringView str)

この関数は append() をオーバーロードする。

str で表示された Latin-1 文字列をこの文字列に追加します。

[since 6.0] QString &QString::append(QStringView v)

この関数は append() をオーバーロードしたものです。

与えられた文字列ビューv をこの文字列に追加し、結果を返します。

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

[since 6.5] QString &QString::append(QUtf8StringView str)

この関数は append() をオーバーロードする。

UTF-8 文字列ビューstr をこの文字列に追加します。

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

QString &QString::append(const QByteArray &ba)

この関数は append() をオーバーロードする。

バイト配列ba をこの文字列に追加します。指定されたバイト配列は、fromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザから見える文字列がすべてQObject::tr() を通過するようにしたい場合に便利です。

QString &QString::append(const char *str)

この関数は append() をオーバーロードする。

この文字列に文字列str を追加します。与えられた const char ポインタはfromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザから見える文字列がすべてQObject::tr() を通過するようにしたい場合に便利です。

QString &QString::append(const QChar *str, qsizetype len)

この関数は append() をオーバーロードする。

QChar 配列str からlen 文字をこの文字列に追加します。

QString QString::arg(const QString &a, int fieldWidth = 0, QChar fillChar = u' ') const

最下位のプレースマーカーを文字列a に置き換えたこの文字列のコピー、すなわち%1,%2, ...,%99 を返す。

fieldWidth は、引数 が占有するスペースの最小量を指定する。 が よりも少ないスペースしか必要としない場合、 に文字 がパディングされる。正の を指定す る と 、 テ キ ス ト は右揃えにな り ます。負の値 を指定すると、左揃えのテキストが生成されます。a a fieldWidth fieldWidth fillChar fieldWidth fieldWidth

この例では、ファイル一覧の処理中に進捗状況を報告するためのstatus 文字列を作成する方法を示す：

QString i;           // current file's number
QString total;       // number of files to process
QString fileName;    // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

まず、arg(i) が%1 を置き換える。次にarg(total) が%2 を置き換える。最後に、arg(fileName) が%3 を置き換える。

arg()をasprintf()よりも使用する利点の1つは、アプリケーションの文字列が他の言語に翻訳された場合、番号付けされたプレースマーカーの順序が変わる可能性がありますが、各arg()は、それがどこに現れても、最も低い番号の置き換えられていないプレースマーカーを置き換えます。また、プレースマーカー%i が文字列中に複数回現れた場合、arg() はそれらすべてを置き換えます。

置換されていないプレースマーカーが残っていない場合、警告メッセージが出力され、結果は未定義となる。プレースマーカー番号は 1 から 99 の範囲でなければならない。

QString QString::arg(QChar a, int fieldWidth = 0, QChar fillChar = u' ') const

この関数は arg() をオーバーロードする。

QString QString::arg(QLatin1StringView a, int fieldWidth = 0, QChar fillChar = u' ') const

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

最下位のプレースマーカーをa で見た Latin-1 文字列に置き換えたこの文字列のコピー、すなわち%1 、%2 、...、%99 を返す。

fieldWidth は、 が占有するスペースの最小量を指定する。 が よりも少ないスペースしか必要としない場合、 に文字 がパディングされる。正の を指定す る と 、 テ キ ス ト は右揃えにな り ます。負の値 を指定すると、左揃えのテキストが生成される。a a fieldWidth fieldWidth fillChar fieldWidth fieldWidth

asprintf （）よりもarg（）を使う利点の1つは、アプリケーションの文字列が他の言語に翻訳された場合、番号付けされたプレースマーカーの順序が変わる可能性がありますが、各arg（）は、それがどこに現れるかに関係なく、最も低い番号の置換されていないプレースマーカーを置き換えます。また、プレースマーカー%i が文字列中に複数回現れると、arg() はそれらすべてを置き換える。

置換されていないプレースマーカーが残っていない場合、警告メッセージが表示され、結果は未定義となる。プレースマーカー番号は1～99の範囲でなければならない。

QString QString::arg(QStringView a, int fieldWidth = 0, QChar fillChar = u' ') const

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

最下位のプレースマーカーを文字列a 、すなわち%1,%2, ... ,%99 に置き換えたこの文字列のコピーを返す。

fieldWidth は、 が占有する最小スペースを指定する。 が よりも少ないスペースしか必要としない場合、 に文字 がパディングされる。正の を指定す る と 、 テ キ ス ト は右揃えにな り ます。負の を指定す る と 、 左揃えのテ キ ス ト が生成 さ れます。a a fieldWidth fieldWidth fillChar fieldWidth fieldWidth

この例では、ファイル一覧の処理中に進捗状況を報告するためのstatus 文字列を作成する方法を示す：

int i;                // current file's number
int total;            // number of files to process
QStringView fileName; // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

まず、arg(i) が%1 を置き換える。次にarg(total) が%2 を置き換える。最後に、arg(fileName) が%3 を置き換える。

asprintf() よりも arg() を使用する利点の1つは、アプリケーションの文字列が他 の言語に翻訳された場合、番号付けされたプレースマーカーの順序が変わる可能性があ るが、各arg()は、それがどこに現れたとしても、一番下の番号の置換され ていないプレースマーカーを置き換えるということである。また、プレースマーカー%i が文字列中に複数回現れると、arg() はそれらすべてを置き換える。

置換されていないプレースマーカーが残っていない場合、警告メッセージが表示され、結果は未定義となる。プレースマーカー番号は1～99の範囲でなければならない。

QString QString::arg(char a, int fieldWidth = 0, QChar fillChar = u' ') const

この関数は arg() をオーバーロードする。

a 引数は Latin-1 文字として解釈される。

QString QString::arg(int a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

引数a は基数base で表され、デフォルトでは10であり、2以上36以下でなければならない。10以外の基数の場合、a は符号なし整数として扱われる。

fieldWidth は、 をパディングして文字 で埋めるスペースの最小量を指定する。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

'%'の後に'L'を続けることができ、その場合、シーケンスはa のローカライズされた表現に置き換えられる。 変換は、QLocale::setDefault() で設定されたデフォルトロケールを使用する。デフォルトロケールが指定されていない場合、システムロケールが使用される。base が10でない場合、'L'フラグは無視される。

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Number Formatsも参照のこと。

QString QString::arg(long a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値は右寄せテキストを生成し、負の値は左寄せテキストを生成します。a fillChar

引数a は、与えられたbase で表現され、デフォルトでは 10 であり、2 から 36 の間でなければならない。

'%'の後に'L'を続けることができ、その場合、シーケンスはa のローカライズされた表現に置き換えられる。 変換はデフォルトのロケールを使用する。デフォルトのロケールは、アプリケーション起動時のシステムのロケール設定から決定される。このロケールは、QLocale::setDefault() を使用して変更することができる。base が10でない場合、'L'フラグは無視される。

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Number Formatsも参照のこと 。

QString QString::arg(qlonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

base 引数は、整数a を文字列に変換する際に使用する基数を指定する。基数は2から36の間でなければならず、8は8進数、10は10進数、16は16進数である。

Number Formatsも参照のこと 。

QString QString::arg(qulonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

base 引数は、整数a を文字列に変換する際に使用する基数を指定します。base は2から36の間でなければならず、8は8進数、10は10進数、16は16進数です。

Number Formatsも参照のこと 。

QString QString::arg(short a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

base 引数は、整数a を文字列に変換する際に使用する基数を指定する。基数は2から36の間でなければならず、8は8進数、10は10進数、16は16進数である。

Number Formatsも参照のこと 。

QString QString::arg(uint a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

引数base は、整数a を文字列に変換する際に使用する基数を指定する。基数は2以上36以下でなければならない。

Number Formatsも参照のこと 。

QString QString::arg(ulong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

base 引数は、整数a を文字列に変換する際に使用する基数を指定する。基数は2から36の間でなければならず、8は8進数、10は10進数、16は16進数である。

Number Formatsも参照のこと 。

QString QString::arg(ushort a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになる。a fillChar

base 引数は、整数a を文字列に変換する際に使用する基数を指定する。基数は2から36の間でなければならず、8は8進数、10は10進数、16は16進数である。

Number Formatsも参照のこと 。

QString QString::arg(double a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

この関数はarg()をオーバーロードする。

引数a は、指定されたformat とprecision に従ってフォーマットされる。詳細はFloating-point Formats を参照。

fieldWidth は、 がパディングされ、文字 で埋められるスペースの最小量を指定します。正の値を指定すると右寄せテキストになり、負の値を指定すると左寄せテキストになります。a fillChar

double d = 12.34;
QString str = QString("delta: %1").arg(d, 0, 'E', 3);
// str == "delta: 1.234E+01"

QLocale::toString()、QLocale::FloatingPointPrecisionOption 、Number Formatsも参照 。

[static] QString QString::asprintf(const char *cformat, ...)

フォーマット文字列cformat と任意の引数リストから、フォーマット文字列を安全に構築します。

書式文字列は、標準C++ライブラリのprintf()が提供する変換指定子、長さ修飾子、フラグをサポートしています。cformat 文字列と%s 引数は、UTF-8エンコードされていなければならない。

QString result;
QTextStream(&result) << "pi = " << 3.14;
// result == "pi = 3.14"

translations の場合、特に文字列に複数のエスケープシーケンスが含まれる場合は、代わりにarg() 関数の使用を検討する必要があります。これにより、置換の順序をトランスレータが制御できるようになります。

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

[since 6.6] QString &QString::assign(QAnyStringView v)

この文字列の内容をv のコピーで置き換え、この文字列への参照を返す。

この文字列のサイズは、v.toString() によってあたかも UTF-16 に変換されたv のサイズに等しくなる。ただし、QAnyStringView::toString() とは異なり、この関数は、推定サイズがこの文字列の容量を超えるか、この文字列が共有されている場合にのみ、メモリを確保します。

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

QAnyStringView::toString()も参照してください 。

[since 6.6] template <typename InputIterator, QString::if_compatible_iterator<InputIterator> = true> QString &QString::assign(InputIterator first, InputIterator last)

この文字列の内容を、イテレータ範囲 [first,last] 内の要素のコピーに置き換え、この文字列への参照を返します。

この文字列のサイズは、範囲 [first,last] 内の要素のデコードされた長さに等しくなります。この関数は、入力文字セットを透過的に UTF-16 に再コード化するので、範囲自体の長さと同じである必要はありません。

この関数は、範囲内の要素数、またはUTF-16エンコードされていない入力の場合は、結果の文字列の可能な最大サイズが、この文字列の容量を超える場合、またはこの文字列が共有されている場合にのみ、メモリを割り当てます。

• QChar
• QLatin1Char
• char
• unsigned char
• signed char
• char8_t
• char16_t
• (Windowsのような16ビット型のプラットフォームでは)wchar_t
• char32_t

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

[since 6.6] QString &QString::assign(qsizetype n, QChar c)

この文字列の内容をc のn コピーで置き換え、この文字列への参照を返す。

この文字列のサイズはn に等しく、負であってはならない。

この関数は、n がこの文字列の容量を超えるか、この文字列が共有されている場合にのみ、メモリを割り当てます。

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

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

const QChar QString::at(qsizetype position) const

文字列中の指定されたインデックスposition にある文字を返す。

position は、文字列中の有効なインデックス位置でなければならない (すなわち、0 <=position <size())。

operator[]()も参照 。

QChar &QString::back()

文字列の最後の文字への参照を返します。operator[](size() - 1) と同じ。

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

front()、at()、operator[]()も参照 。

QChar QString::back() const

文字列の最後の文字を返す。at(size() - 1) と同じ。

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

front()、at()、operator[]()も参照 。

QString::iterator QString::begin()

文字列の最初の文字を指すSTL 形式のイテレータを返します。

constBegin() およびend()も参照 。

QString::const_iterator QString::begin() const

この関数はbegin()をオーバーロードする。

qsizetype QString::capacity() const

再割り当てを行わずに文字列に格納できる最大文字数を返します。

この関数の唯一の目的は、QString'のメモリ使用量を微調整する手段を提供することです。一般に、この関数を呼び出す必要はほとんどないだろう。文字列内の文字数を知りたい場合は、size() を呼び出す。

reserve() およびsqueeze()も参照の こと。

QString::const_iterator QString::cbegin() const

文字列の最初の文字を指す constSTL 形式のイテレータを返します。

begin() およびcend()も参照 。

QString::const_iterator QString::cend() const

文字列の最後の文字の直後を指す constSTL 形式のイテレータを返します。

cbegin() およびend()も参照 。

void QString::chop(qsizetype n)

文字列の末尾からn 文字を削除する。

n がsize() 以上の場合、結果は空文字列となる。n が負の場合、ゼロを渡すのと同じである。

例

QString str("LOGOUT\r\n");
str.chop(2);
// str == "LOGOUT"

文字列の先頭から文字を削除したい場合は、代わりにremove() を使用する。

truncate()、resize()、remove()、QStringView::chop()も参照の こと。

void QString::clear()

文字列の内容をクリアして null にする。

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

[static noexcept] int QString::compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

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

大文字小文字を区別する比較は、文字のUnicodeの数値のみに基づいており、非常に高速ですが、人間が期待するものではありません。localeAwareCompare （）を使用して、ユーザが見える文字列をソートすることを検討してください。

int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

operator==()、operator<()、operator>()、Comparing Strings も参照のこと 。

[noexcept] int QString::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は compare() をオーバーロードする。

大文字小文字を区別する設定cs を使用して、ch との比較を実行します。

[noexcept] int QString::compare(QLatin1StringView other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は compare() をオーバーロードする。

compare(*this,other,cs) と同じです。

[noexcept] int QString::compare(QStringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は compare() をオーバーロードする。

大文字小文字を区別する設定cs を使用して、s との比較を実行します。

[noexcept] int QString::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は compare() をオーバーロードしたものである。

この文字列と文字列other をレキシカルに比較し、この文字列がother より小さい場合は負の整数を、other より大きい場合は正の整数を、等しい場合はゼロを返します。

compare(*this,other,cs) と同じ。

[static noexcept] int QString::compare(QLatin1StringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は compare() をオーバーロードする。

大文字小文字を区別する設定cs を使用して、s1 とs2 の比較を実行します。

[static noexcept] int QString::compare(QStringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は compare() をオーバーロードする。

[static noexcept] int QString::compare(const QString &s1, QLatin1StringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は compare() をオーバーロードする。

大文字小文字を区別する設定cs を使用して、s1 とs2 の比較を実行します。

[static noexcept] int QString::compare(const QString &s1, QStringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は compare() をオーバーロードする。

QString::const_iterator QString::constBegin() const

文字列の最初の文字を指す constSTL 形式のイテレータを返します。

begin() およびconstEnd()も参照 。

const QChar *QString::constData() const

QString に格納されているデータへのポインタを返します。 このポインタを使用して、文字列を構成する文字にアクセスすることができます。

ポインタは、文字列が変更されない限り有効であることに注意してください。

data()、operator[]()、およびfromRawData()も参照してください 。

QString::const_iterator QString::constEnd() const

文字列の最後の文字の直後を指す constSTL 形式のイテレータを返します。

constBegin() およびend()も参照 。

bool QString::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

正規表現re がこの文字列のどこかにマッチする場合はtrue を返し、マッチしない場合はfalse を返す。

マッチに成功し、rmatch がnullptr でない場合は、マッチの結果をrmatch が指すQRegularExpressionMatch オブジェクトに書き込みます。

QRegularExpression::match()も参照のこと 。

bool QString::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この文字列が文字列str の出現回数を含む場合はtrue を返し、そうでない場合はfalse を返す。

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

例

QString str = "Peter Pan";
str.contains("peter", Qt::CaseInsensitive);    // returns true

indexOf() およびcount()も参照 。

bool QString::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は contains() をオーバーロードする。

この文字列がch の文字を含む場合はtrue を返し、そうでない場合はfalse を返します。

bool QString::contains(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は contains() をオーバーロードする。

この文字列がラテン文字1文字列str を含んでいる場合はtrue を返し、そうでない場合はfalse を返します。

[noexcept] bool QString::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は contains() をオーバーロードする。

この文字列が文字列ビューstr の出現回数を含む場合はtrue を返し、そうでない場合はfalse を返します。

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

indexOf() およびcount()も参照 。

qsizetype QString::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この文字列の中で、str という文字列が（重複している可能性がある）出現する回数を返す。

cs がQt::CaseSensitive (デフォルト) の場合は大文字小文字を区別し、それ以外の場合は区別しない。

contains() およびindexOf()も参照 。

qsizetype QString::count(const QRegularExpression &re) const

この関数は count() をオーバーロードしたものである。

正規表現re が文字列にマッチした回数を返します。

歴史的な理由により、この関数は重複したマッチを数えます。 そのため、以下の例では "ana" あるいは "ama" のインスタンスが 4 つ存在することになります：

QString str = "banana and panama";
str.count(QRegularExpression("a[nm]a"));    // returns 4

この動作は、QRegularExpressionMatchIterator を使って単に文字列のマッチを繰り返し処理するのとは異なります。

QRegularExpression::globalMatch()も参照のこと 。

qsizetype QString::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は count() をオーバーロードする。

文字列中の文字ch の出現回数を返す。

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

contains() およびindexOf()も参照 。

[since 6.0] qsizetype QString::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は count() をオーバーロードする。

この文字列の中で、文字列 viewstr が（重複している可能性がある）出現する回数を返す。

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

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

contains() およびindexOf()も参照してください 。

QString::const_reverse_iterator QString::crbegin() const

文字列の最初の文字を逆順に指す、STL 形式の逆順イテレータを返します。

begin()、rbegin()、rend()も参照 。

QString::const_reverse_iterator QString::crend() const

文字列の最後の文字の直後を指す、 constSTL 形式の逆順イテレータを返します。

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

QChar *QString::data()

QString に格納されているデータへのポインタを返します。 このポインタを使用して、文字列を構成する文字にアクセスしたり、変更したりすることができます。

constData() やunicode() と異なり、返されるデータは常に ' \0' 終端です。

例

QStringstr= "Hello world"；QChar*data =str.data();while(!data->isNull()) {*data= str.data();while(!data->isNull())    qDebug() << data->unicode();
   ++data; }

ポインタは、文字列が他の手段で変更されない限り有効であることに注意。読み取り専用アクセスでは、constData （）の方がディープコピーが発生しないため高速である。

constData() およびoperator[]()も参照のこと 。

const QChar *QString::data() const

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

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

QString::iterator QString::end()

文字列の最後の文字の直後を指すSTL 形式のイテレータを返します。

begin() およびconstEnd()も参照 。

QString::const_iterator QString::end() const

この関数は end() をオーバーロードする。

bool QString::endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

文字列がs で終わっていればtrue を返し、そうでなければfalse を返す。

cs がQt::CaseSensitive (デフォルト) の場合、検索は大文字小文字を区別する。

QString str = "Bananas";
str.endsWith("anas");         // returns true
str.endsWith("pple");         // returns false

startsWith()も参照 。

bool QString::endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

文字列がc で終わっていればtrue を返し、そうでなければfalse を返す。

この関数は endsWith() をオーバーロードする。

bool QString::endsWith(QLatin1StringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は endsWith() をオーバーロードします。

[noexcept] bool QString::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は endsWith() をオーバーロードする。

文字列が文字列ビューstr で終わっている場合はtrue を返し、そうでない場合はfalse を返します。

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

startsWith()も参照のこと 。

[since 6.1] QString::iterator QString::erase(QString::const_iterator first, QString::const_iterator last)

半開きの範囲 [first,last ] 内の文字を文字列から削除します。最後に消去された文字の直後の文字（つまり、消去前にlast で参照された文字）へのイテレータを返します。

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

[since 6.5] QString::iterator QString::erase(QString::const_iterator it)

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

文字列からit で示される文字を削除します。削除された文字の直後の文字へのイテレータを返します。

QString c = "abcdefg";
auto it = c.erase(c.cbegin()); // c is now "bcdefg"; "it" points to "b"

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

QString &QString::fill(QChar ch, qsizetype size = -1)

文字列のすべての文字を文字ch に設定する。size が -1 (デフォルト) と異なる場合、文字列はあらかじめsize にリサイズされる。

例

QString str = "Berlin";
str.fill('z');
// str == "zzzzzz"

str.fill('A', 2);
// str == "AA"

resize()も参照 。

[static] QString QString::fromCFString(CFStringRef string)

string CFString のコピーを含む新しいQString を構築する。

[static, since 6.6] QString QString::fromEcmaString(emscripten::val jsString)

ECMAScript 文字列 jsString をQString に変換します。 提供されたパラメータが文字列でない場合、動作は未定義です。

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

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

[static] QString QString::fromLatin1(const char *str, qsizetype size)

Latin-1 文字列str の最初のsize 文字で初期化されたQString を返す。

size が-1 の場合、代わりにstrlen(str) が使用される。

toLatin1()、fromUtf8() およびfromLocal8Bit()も参照 。

[static, since 6.0] QString QString::fromLatin1(QByteArrayView str)

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

Latin-1 文字列str で初期化されたQString を返します。

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

[static] QString QString::fromLatin1(const QByteArray &str)

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

Latin-1 文字列str で初期化されたQString を返します。

[static] QString QString::fromLocal8Bit(const char *str, qsizetype size)

8 ビット文字列str の最初の文字size で初期化されたQString を返す。

size が-1 の場合、代わりにstrlen(str) が使われる。

Unixシステムでは、これはfromUtf8() と等価である。Appleシステムでは、この関数はNSString.defaultCStringEncodingや CFStringGetSystemEncoding()を考慮しないことに注意してください。これらの関数は通常、レガシーの「Western (Mac OS Roman)」エンコーディングを返すため、最新のAppleオペレーティングシステムでは使用すべきではありません。Windowsでは、システムの現在のコードページが使用される。

toLocal8Bit(),fromLatin1(),fromUtf8()も参照 。

[static, since 6.0] QString QString::fromLocal8Bit(QByteArrayView str)

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

8ビット文字列str で初期化されたQString を返す。

Unix システムでは、これはfromUtf8() と等価です。Appleシステムでは、この関数はNSString.defaultCStringEncodingや CFStringGetSystemEncoding()を考慮しないことに注意してください。なぜなら、これらの関数は通常、レガシーの「Western (Mac OS Roman)」エンコーディングを返すからです。Windows では、システムの現在のコード・ページが使用されます。

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

[static] QString QString::fromLocal8Bit(const QByteArray &str)

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

8ビット文字列str で初期化されたQString を返す。

Unix システムでは、これはfromUtf8() と等価です。Appleシステムでは、この関数はNSString.defaultCStringEncodingや CFStringGetSystemEncoding()を考慮しないことに注意してください。なぜなら、これらの関数は通常、レガシーの「Western (Mac OS Roman)」エンコーディングを返すからです。Windows では、システムの現在のコード・ページが使用されます。

[static] QString QString::fromNSString(const NSString *string)

string NSString のコピーを含む新しいQString を構築する。

[static] QString QString::fromRawData(const QChar *unicode, qsizetype size)

配列unicode 内の最初のsize Unicode キ ャ ラ ク タ を使用す るQString を構築 し ます。unicode 内のデータはコピーされない。呼び出し元は、QString （またはその変更されていないコピー）が存在する限り、unicode が削除または変更されないことを保証できなければならない。

QString 、またはそのコピーを変更しようとすると、データのディープコピーが作成され、生データが変更されないことが保証される。

以下は、QString にデータをコピーすることなく、メモリ上の生データに対してQRegularExpression を使用する方法の例である：

QRegularExpression pattern("\u00A4");
static const QChar unicode[] = {
        0x005A, 0x007F, 0x00A4, 0x0060,
        0x1009, 0x0020, 0x0020};
qsizetype size = sizeof(unicode) / sizeof(QChar);

QString str = QString::fromRawData(unicode, size);
if (str.contains(pattern) {
    // ...
}

fromUtf16() およびsetRawData()も参照 。

[static] QString QString::fromStdString(const std::string &str)

str 文字列のコピーを返す。与えられた文字列は UTF-8 でエンコードされていると仮定され、fromUtf8() 関数を使用してQString に変換される。

fromLatin1()、fromLocal8Bit()、fromUtf8()、QByteArray::fromStdString()も参照 。

[static] QString QString::fromStdU16String(const std::u16string &str)

str 文字列のコピーを返す。与えられた文字列は UTF-16 でエンコードされていると仮定され、fromUtf16() 関数を使用してQString に変換される。

fromUtf16()、fromStdWString()、fromStdU32String()も参照 。

[static] QString QString::fromStdU32String(const std::u32string &str)

str 文字列のコピーを返す。与えられた文字列は UTF-32 でエンコードされていると仮定され、fromUcs4() 関数を使用してQString に変換される。

fromUcs4()、fromStdWString()、fromStdU16String()も参照 。

[static] QString QString::fromStdWString(const std::wstring &str)

str の文字列のコピーを返す。与えられた文字列は、wchar_t のサイズが 2 バイトの場合は utf16 でエンコードされていると仮定され (windows など)、 wchar_t のサイズが 4 バイトの場合は ucs4 でエンコードされていると仮定される (ほとんどの Unix システム)。

fromUtf16()、fromLatin1()、fromLocal8Bit()、fromUtf8()、fromUcs4()、fromStdU16String()、fromStdU32String()も参照のこと 。

[static] QString QString::fromUcs4(const char32_t *unicode, qsizetype size = -1)

Unicode 文字列unicode (UTF-32 としてエンコード) の最初のsize 文字で初期化されたQString を返す。

size が -1 (デフォルト) の場合、unicode は ˶0'-terminated でなければなりません。

toUcs4()、fromUtf16()、utf16()、setUtf16()、fromWCharArray()、およびfromStdU32String()も参照してください 。

[static] QString QString::fromUtf8(const char *str, qsizetype size)

UTF-8 文字列str の最初のsize バイトで初期化されたQString を返す。

size が-1 の場合、代わりにstrlen(str) が使われます。

UTF-8はUnicodeコーデックであり、QString のようなUnicode文字列のすべての文字を表現することができます。 しかし、UTF-8では無効なシーケンスが可能であり、そのようなものが見つかった場合、1つ以上の「置換文字」で置き換えられるか、抑制されます。これらには、非Unicodeシーケンス、非文字、オーバーロングシーケンス、UTF-8にエンコードされたサロゲートコードポイントが含まれます。

この関数は、すべてのUTF-8文字が受信データ内で終了している限り、受信データをインクリメンタルに処理するために使用することができる。文字列の末尾にある終了していない文字は、置換または抑制される。ステートフルなデコードを行うには、QStringDecoder を使用してください。

toUtf8()、fromLatin1()、fromLocal8Bit()も参照の こと。

[static, since 6.0] QString QString::fromUtf8(QByteArrayView str)

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

UTF-8 文字列str で初期化されたQString を返します。

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

[static] QString QString::fromUtf8(const QByteArray &str)

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

UTF-8 文字列str で初期化されたQString を返します。

[static, since 6.1] QString QString::fromUtf8(const char8_t *str)

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

このオーバーロードは、C++20 モードでコンパイルした場合のみ使用できます。

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

[static, since 6.0] QString QString::fromUtf8(const char8_t *str, qsizetype size)

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

このオーバーロードは、C++20 モードでコンパイルした場合のみ使用できます。

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

[static] QString QString::fromUtf16(const char16_t *unicode, qsizetype size = -1)

Unicode 文字列unicode (ISO-10646-UTF-16 エンコード) の最初のsize 文字で初期化されたQString を返す。

size が -1 (デフォルト) の場合、unicode は \0'- 終端でなければなりません。

この関数は、バイトオーダーマーク（BOM）をチェックする。BOM がない場合、ホストのバイト順序が仮定される。

この関数は、他の Unicode 変換に比べて遅い。可能であれば、QString(constQChar *, qsizetype) またはQString(constQChar *) を使用してください。

QString Unicode データのディープコピーを作成します。

utf16(),setUtf16(),fromStdU16String()も参照してください 。

[static] QString QString::fromWCharArray(const wchar_t *string, qsizetype size = -1)

string が指す先頭のwchar_t 配列の最初のsize コードユニットを読み込んで Unicode に変換し、結果をQString として返します。wchar_t で使用されるエンコーディングは、型のサイズが 4 バイトの場合は UTF-32、2 バイトの場合は UTF-16 と見なされます。

size が-1(デフォルト)の場合、string は'˶0'終端でなければなりません。

fromUtf16()、fromLatin1()、fromLocal8Bit()、fromUtf8()、fromUcs4()、fromStdWString()も参照 。

QChar &QString::front()

文字列の最初の文字への参照を返します。operator[](0) と同じ。

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

back()、at()、operator[]()も参照 。

QChar QString::front() const

文字列の最初の文字を返す。at(0) と同じ。

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

back()、at()、operator[]()も参照 。

qsizetype QString::indexOf(QLatin1StringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

from のインデックス位置から前方へ検索して、この文字列内でstr が最初に表示する Latin-1 文字列のインデックス位置を返す。str が見つからない場合は -1 を返す。

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

例

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

例：from が -1 の場合、検索は最後の文字から始まり、-2 の場合、最後から次の文字から始まる。

lastIndexOf()、contains()、count()も参照の こと。

qsizetype QString::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

インデックス位置from から前方へ検索して、文字列中の正規表現re に最初にマッチするインデックス位置を返します。re がどこにもマッチしなかった場合は -1 を返す。

マッチに成功し、rmatch がnullptr でない場合は、マッチの結果をrmatch が指すQRegularExpressionMatch オブジェクトにも書き込みます。

例

QString str = "the minimum";
str.indexOf(QRegularExpression("m[aeiou]"), 0);       // returns 4

QString str = "the minimum";
QRegularExpressionMatch match;
str.indexOf(QRegularExpression("m[aeiou]"), 0, &match);       // returns 4
// match.captured() == mi

qsizetype QString::indexOf(const QString &str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この文字列内で最初に出現する文字列str のインデックス位置を、インデックス位置from から順に検索して返す。str が見つからない場合は -1 を返す。

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

例

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

例：from が -1 の場合、検索は最後の文字から始まり、-2 の場合、最後から次の文字から始まる。

lastIndexOf()、contains()、count()も参照の こと。

qsizetype QString::indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は indexOf() をオーバーロードする。

インデックス位置from から前方に検索して、この文字列内でch という文字が最初に出現するインデックス位置を返す。ch が見つからない場合は -1 を返す。

[noexcept] qsizetype QString::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は indexOf() をオーバーロードする。

インデックス位置from から前方を検索して、この文字列内で最初に出現する文字列ビューstr のインデックス位置を返します。str が見つからない場合は -1 を返します。

cs がQt::CaseSensitive (デフォルト) の場合、検索は大文字小文字を区別します。

from が -1 の場合、検索は最後の文字から開始され、-2 の場合は次の文字から開始される。

QStringView::indexOf()、lastIndexOf()、contains()、count()も参照の こと。

QString &QString::insert(qsizetype position, const QString &str)

与えられたインデックスposition に文字列str を挿入し、この文字列への参照を返す。

例

QString str = "Meal";
str.insert(1, QString("ontr"));
// str == "Montreal"

例: この文字列は、挿入に合わせて大きくなる。position が文字列の終端を越えている場合、文字列にスペース文字が追加され、このposition の後にstr が続く。

append()、prepend()、replace()、remove()も参照のこと 。

QString &QString::insert(qsizetype position, QChar ch)

この関数は insert() をオーバーロードする。

文字列の指定されたインデックスposition にch を挿入する。

この文字列は、挿入に合わせて大きくなる。position が文字列の終端を越えている場合、このposition に達するまで文字列にスペース文字が追加され、続いてch が追加される。

QString &QString::insert(qsizetype position, QLatin1StringView str)

この関数はinsert()をオーバーロードする。

与えられたインデックスposition に、str で見た Latin-1 文字列を挿入する。

この文字列は、挿入に合わせて大きくなる。position が文字列の終端を越えている場合、空白文字が文字列に追加され、このposition に到達し、その後にstr が続きます。

[since 6.0] QString &QString::insert(qsizetype position, QStringView str)

この関数はinsert()をオーバーロードする。

与えられたインデックスposition に文字列ビューstr を挿入し、この文字列への参照を返します。

この文字列は、挿入に合わせて大きくなります。position が文字列の終端を超えている場合、このposition に達するまで文字列にスペース文字が追加され、続いてstr が追加されます。

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

[since 6.5] QString &QString::insert(qsizetype position, QUtf8StringView str)

この関数はinsert()をオーバーロードする。

与えられたインデックスposition に UTF-8 文字列ビューstr を挿入します。

この文字列は、挿入に合わせて大きくなる。position が文字列の終端を超えている場合、空白文字が文字列に追加され、このposition に到達し、続いてstr に到達します。

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

QString &QString::insert(qsizetype position, const QByteArray &str)

この関数はinsert()をオーバーロードする。

str の内容を UTF-8 として解釈し、指定されたインデックスposition にエンコードされた Unicode 文字列を挿入し、この文字列への参照を返します。

この文字列は、挿入に合わせて大きくなります。position が文字列の終端を越えている場合、このposition に達するまで文字列にスペース文字が追加され、続いてstr が追加される。

この関数は、QT_NO_CAST_FROM_ASCII が定義されているときには利用できない。

QString &QString::insert(qsizetype position, const char *str)

この関数はinsert()をオーバーロードする。

与えられたインデックスposition に C の文字列str を挿入し、この文字列への参照を返す。

この文字列は、挿入に合わせて大きくなる。position が文字列の終端を越えている場合、文字列にスペース文字が追加され、このposition に到達し、続いてstr に到達する。

この関数は、QT_NO_CAST_FROM_ASCII が定義されているときには利用できない。

QString &QString::insert(qsizetype position, const QChar *unicode, qsizetype size)

この関数はinsert()をオーバーロードする。

文字列の指定されたインデックスposition に、QChar 配列unicode の最初のsize 文字を挿入する。

この文字列は、挿入に合わせて大きくなる。position が文字列の終端を越えている場合、このposition に達するまで文字列にスペース文字が追加され、続いてQChar 配列unicode のsize 文字が追加される。

[noexcept] bool QString::isEmpty() const

文字列に文字がない場合はtrue を返し、そうでない場合はfalse を返す。

例：

QString().isEmpty();            // returns true
QString("").isEmpty();          // returns true
QString("x").isEmpty();         // returns false
QString("abc").isEmpty();       // returns false

size()も参照のこと 。

bool QString::isLower() const

文字列が小文字の場合、つまりtoLower() の折りたたみと同じ場合はtrue を返す。

toLowerこれは、文字列に大文字が含まれていないという意味ではないことに注意してください（大文字の中には、小文字の折りたたみを持たないものがあります。詳しくはUnicode標準の3.13節を参照してください。

QChar::toLower() およびisUpper()も参照 。

bool QString::isNull() const

この文字列が NULL の場合はtrue を返し、そうでない場合はfalse を返す。

例

QString().isNull();             // returns true
QString("").isNull();           // returns false
QString("abc").isNull();        // returns false

Qtでは、歴史的な理由からNULL文字列と空文字列を区別しています。ほとんどのアプリケーションで重要なのは、文字列が何らかのデータを含んでいるかどうかであり、これはisEmpty() 関数を使って判断することができます。

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

bool QString::isRightToLeft() const

文字列が右から左に読まれた場合はtrue を返す。

QStringView::isRightToLeft()も参照のこと 。

bool QString::isUpper() const

文字列が大文字の場合、つまりtoUpper() の折りたたみと同じ場合はtrue を返す。

toUpperこれは、文字列に小文字が含まれていないことを意味しないことに注意してください（小文字の中には、大文字の折りたたみを持たないものがあります。詳しくはUnicode標準の3.13節を参照してください。

QChar::toUpper() およびisLower()も参照 。

[noexcept] bool QString::isValidUtf16() const

文字列が有効なUTF-16エンコード・データを含んでいればtrue を、そうでなければfalse を返す。

この関数はデータの特別な検証を行わないことに注意。単にUTF-16から正常にデコードできるかどうかをチェックするだけである。データはホスト側のバイトオーダーであると仮定される。

QStringView::isValidUtf16()も参照 。

qsizetype QString::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

from文字列中の正規表現re の最後のマッチのインデックス位置を返す。

from が -1 の場合、検索は最後の文字から始まり、-2 の場合は次の文字から始まる。

re がどこにもマッチしなかった場合は -1 を返す。

マッチが成功し、rmatch がnullptr でない場合、マッチの結果をrmatch が指すQRegularExpressionMatch オブジェクトにも書き込みます。

例

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QString str = "the minimum";
QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

qsizetype QString::lastIndexOf(const QString &str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

インデックス位置from から後方へ検索して、この文字列の中で最後に出現した文字列str のインデックス位置を返す。

from が -1 の場合、検索は最後の文字から開始され、-2 の場合は次の文字から開始される。

str が見つからなければ -1 を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

例

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

indexOf()、contains()、count()も参照のこと 。

[noexcept, since 6.3] qsizetype QString::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードします。

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

[since 6.2] qsizetype QString::lastIndexOf(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

この文字列内で最後に出現した文字列str のインデックス位置を返す。str が見つからない場合は -1 を返す。

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

例

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(),contains(),count()も参照してください 。

[noexcept, since 6.2] qsizetype QString::lastIndexOf(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

この文字列内で最後に出現した文字列ビューstr のインデックス位置を返す。str が見つからない場合は -1 を返す。

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

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

indexOf(),contains(),count()も参照してください 。

[since 6.2] qsizetype QString::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

この関数は lastIndexOf() をオーバーロードしたものである。

文字列中の正規表現re の最後のマッチのインデックス位置を返します。re がどこにもマッチしなかった場合は -1 を返す。

マッチに成功し、rmatch がnullptr でない場合は、マッチの結果をrmatch が指すQRegularExpressionMatch オブジェクトにも書き込みます。

例

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QString str = "the minimum";
QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

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

[since 6.2] qsizetype QString::lastIndexOf(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

この文字列内で最後に出現した文字列str のインデックス位置を返す。str が見つからない場合は -1 を返す。

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

例

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(),contains(),count()も参照してください 。

qsizetype QString::lastIndexOf(QChar ch, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

インデックス位置from から後方に検索して、この文字列内で最後に出現した文字ch のインデックス位置を返します。

qsizetype QString::lastIndexOf(QLatin1StringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

インデックス位置from から後方へ検索して、この文字列のstr で表示される Latin-1 文字列の最後の出現文字のインデックス位置を返します。

from が -1 の場合、検索は最後の文字から開始され、-2 の場合、次の文字から開始されます。

str が見つからなければ -1 を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

例

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

indexOf()、contains()、count()も参照のこと 。

[noexcept] qsizetype QString::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この関数は lastIndexOf() をオーバーロードする。

インデックス位置from から後方へ検索して、この文字列内で文字列ビューstr が最後に出現するインデックス位置を返します。

from が -1 の場合、検索は最後の文字から開始され、-2 の場合、次の文字から開始されます。

str が見つからなければ -1 を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

indexOf()、contains()、count()も参照のこと 。

QString QString::leftJustified(qsizetype width, QChar fill = u' ', bool truncate = false) const

fill 文字でパディングされた文字列を含む、サイズwidth の文字列を返す。

truncate がfalse で、文字列のsize() がwidth より大きい場合、返される文字列は文字列のコピーである。

QString s = "apple";
QString t = s.leftJustified(8, '.');    // t == "apple..."

truncate がtrue で、文字列のsize() がwidth よりも大きい場合、文字列のコピーのうち、位置width 以降の文字が削除され、コピーが返される。

QString str = "Pineapple";
str = str.leftJustified(5, '.', true);    // str == "Pinea"

rightJustified()も参照のこと 。

[noexcept] qsizetype QString::length() const

この文字列の文字数を返す。size() と同じ。

resize()も参照 。

[static] int QString::localeAwareCompare(const QString &s1, const QString &s2)

s1 とs2 を比較し、s1 がs2 より小さい、等しい、または大きい場合に、ゼロより小さい、等しい、または大きい整数を返す。

比較はロケールやプラットフォームに依存した方法で行われる。この関数は、文字列をソートしたリストをユーザーに表示するために使用する。

compare()、QLocale 、Comparing Stringsも参照のこと 。

[since 6.0] int QString::localeAwareCompare(QStringView other) const

この関数は、localeAwareCompare() をオーバーロードする。

この文字列とother の文字列を比較し、この文字列がother の文字列より小さい、等しい、または大きい場合にゼロより小さい、等しい、または大きい整数を返します。

比較はロケールやプラットフォームに依存した方法で行われる。この関数は、文字列のソートされたリストをユーザに提示するために使用する。

localeAwareCompare(*this, other) と同じです。

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

Comparing Stringsも参照してください 。

int QString::localeAwareCompare(const QString &other) const

この関数は、localeAwareCompare() をオーバーロードする。

この文字列とother の文字列を比較し、この文字列がother の文字列より小さい、等しい、または大きい場合にゼロより小さい、等しい、または大きい整数を返します。

比較はロケールやプラットフォームに依存した方法で行われる。この関数は、文字列のソートされたリストをユーザに提示するために使用する。

localeAwareCompare(*this, other) と同じ。

Comparing Stringsも参照のこと 。

[static, since 6.0] int QString::localeAwareCompare(QStringView s1, QStringView s2)

この関数は、localeAwareCompare()をオーバーロードしたものである。

s1 とs2 を比較し、s1 がs2 よりも小さい、等しい、または大きい場合に、0 よりも小さい、等しい、または大きい整数を返します。

比較はロケールやプラットフォームに依存した方法で行われる。この関数は、文字列のソートされたリストをユーザーに表示するために使用します。

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

Comparing Stringsも参照してください 。

QString QString::normalized(QString::NormalizationForm mode, QChar::UnicodeVersion version = QChar::Unicode_Unassigned) const

文字列を、Unicode 標準の与えられたversion に従って、与えられた Unicode 正規化mode で返します。

[static] QString QString::number(long n, int base = 10)

指定されたbase に従って、数値n に相当する文字列を返す。

基数はデフォルトで10であり、2以上36以下でなければならない。10 以外の基数の場合、n は符号なし整数として扱われる。

書式は常にQLocale::C 、つまりEnglish/UnitedStatesを使用する。地域化された数値の文字列表現を得るには、QLocale::toString() を適切なロケールとともに使用する。

long a = 63;
QString s = QString::number(a, 16);             // s == "3f"
QString t = QString::number(a, 16).toUpper();     // t == "3F"

setNum()も参照 。

[static] QString QString::number(double n, char format = 'g', int precision = 6)

浮動小数点数n を表す文字列を返す。

n を表す文字列を、指定されたformat およびprecision に従ってフォーマットして返す。

指数を含む書式では、指数は符号を示し、少なくとも2桁の数字を持ち、必要であれば指数をゼロで左詰めします。

setNum()、QLocale::toString()、QLocale::FloatingPointPrecisionOption 、Number Formatsも参照のこと 。

[static] QString QString::number(int n, int base = 10)

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

[static] QString QString::number(qlonglong n, int base = 10)

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

[static] QString QString::number(qulonglong n, int base = 10)

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

[static] QString QString::number(uint n, int base = 10)

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

[static] QString QString::number(ulong n, int base = 10)

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

QString &QString::prepend(const QString &str)

文字列str をこの文字列の先頭に追加し、この文字列への参照を返す。

QString 、文字列データの先頭に余分なスペースを事前に確保するため、毎回文字列全体を再割り当てすることなく成長させることができるため、この操作は通常非常に高速（一定時間）です。

例

QString x = "ship";
QString y = "air";
x.prepend(y);
// x == "airship"

append() およびinsert()も参照の こと。

QString &QString::prepend(QChar ch)

この関数は prepend() をオーバーロードする。

文字ch をこの文字列に付加する。

QString &QString::prepend(QLatin1StringView str)

この関数は prepend() をオーバーロードする。

str で表示される Latin-1 文字列をこの文字列に追加します。

[since 6.0] QString &QString::prepend(QStringView str)

この関数は prepend() をオーバーロードする。

文字列 viewstr をこの文字列の先頭に追加し、この文字列への参照を返します。

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

[since 6.5] QString &QString::prepend(QUtf8StringView str)

この関数は prepend() をオーバーロードする。

UTF-8 文字列ビューstr をこの文字列に追加します。

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

QString &QString::prepend(const QByteArray &ba)

この関数は prepend() をオーバーロードする。

バイト配列ba をこの文字列に追加します。バイト配列はfromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザから見える文字列がすべてQObject::tr() を通過するようにしたい場合に便利です。

QString &QString::prepend(const char *str)

この関数は prepend() をオーバーロードする。

文字列str をこの文字列に追加します。const char ポインタはfromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザから見える文字列がすべてQObject::tr() を通過するようにしたい場合に便利です。

QString &QString::prepend(const QChar *str, qsizetype len)

この関数は prepend() をオーバーロードする。

QChar 配列str からlen 文字をこの文字列に追加し、この文字列への参照を返します。

void QString::push_back(const QString &other)

この関数はSTLとの互換性のために提供され、与えられたother 文字列をこの文字列の最後に追加する。これはappend(other) と等価である。

append()も参照 。

void QString::push_back(QChar ch)

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

与えられたch 文字をこの文字列の末尾に追加します。

void QString::push_front(const QString &other)

この関数は STL との互換性のために提供され、与えられたother 文字列をこの文字列の先頭に追加する。これはprepend(other) と等価である。

prepend()も参照 。

void QString::push_front(QChar ch)

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

与えられたch 文字をこの文字列の先頭に追加します。

QString::reverse_iterator QString::rbegin()

文字列の最初の文字を指すSTL 形式の逆順イテレータを返します。

begin()、crbegin()、rend()も参照 。

QString::const_reverse_iterator QString::rbegin() const

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

QString &QString::remove(const QRegularExpression &re)

文字列内の正規表現re をすべて削除し、その文字列への参照を返します。例えば

QString r = "Telephone";
r.remove(QRegularExpression("[aeiou]."));
// r == "The"

要素を削除しても、文字列の容量は維持され、割り当てられたメモリの量は減りません。余分な容量を削除し、できるだけ多くのメモリを解放するには、文字列のサイズを最後に変更した後にsqueeze() を呼び出します。

indexOf()、lastIndexOf()、replace()も参照のこと 。

QString &QString::remove(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この文字列内の文字ch をすべて削除し、この文字列への参照を返します。

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

例

QString t = "Ali Baba";
t.remove(QChar('a'), Qt::CaseInsensitive);
// t == "li Bb"

これはreplace(ch, "", cs) と同じである。

要素を削除しても、文字列の容量は維持され、割り当てられたメモリの量は減らない。余分な容量を削除し、できるだけ多くのメモリを解放するには、文字列のサイズを最後に変更した後にsqueeze() を呼び出す。

replace()も参照のこと 。

QString &QString::remove(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この文字列内で指定されたstr 文字列の出現箇所をすべて削除し、この文字列への参照を返す。

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

これはreplace(str, "", cs) と同じである。

要素を削除しても、文字列の容量は維持され、割り当てられたメモリの量は減らない。余分な容量を削除し、できるだけ多くのメモリを解放するには、文字列のサイズを最後に変更した後にsqueeze() を呼び出す。

replace()も参照のこと 。

QString &QString::remove(qsizetype position, qsizetype n)

指定されたposition インデックスから始まる文字列からn 文字を削除し、その文字列への参照を返す。

指定されたposition インデックスが文字列内にあるが、position +n が文字列の末尾を超えている場合、文字列は指定されたposition で切り捨てられる。

n が <= 0の場合、何も変更されない。

QString s = "Montreal";
s.remove(1, 4);
// s == "Meal"

要素を削除しても、文字列の容量は維持され、割り当てられたメモリの量は減らない。余分な容量を削除し、できるだけ多くのメモリを解放するには、文字列のサイズを最後に変更した後にsqueeze() を呼び出す。

insert() およびreplace()も参照のこと 。

QString &QString::remove(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

この文字列から、str によって表示された、与えられた Latin-1 文字列のすべての出現回数を削除し、この文字列への参照を返します。

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

これはreplace(str, "", cs) と同じである。

要素を削除しても、文字列の容量は維持され、割り当てられたメモリの量は減らない。余分な容量を削除し、できるだけ多くのメモリを解放するには、文字列のサイズを最後に変更した後にsqueeze() を呼び出す。

replace()も参照のこと 。

[since 6.5] QString &QString::removeAt(qsizetype pos)

インデックスpos にある文字を削除する。pos が範囲外の場合（つまりpos >=size()）、この関数は何もしません。

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

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

[since 6.5] QString &QString::removeFirst()

この文字列の最初の文字を削除する。文字列が空の場合、この関数は何もしません。

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

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

[since 6.1] template <typename Predicate> QString &QString::removeIf(Predicate pred)

述語pred が真を返すすべての要素を文字列から削除します。文字列への参照を返します。

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

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

[since 6.5] QString &QString::removeLast()

文字列の最後の文字を削除する。文字列が空の場合、この関数は何もしません。

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

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

QString::reverse_iterator QString::rend()

文字列の最後の文字の直後を指すSTL 形式の逆順イテレータを返します。

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

QString::const_reverse_iterator QString::rend() const

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

QString QString::repeated(qsizetype times) const

この文字列のコピーを、指定されたtimes の数だけ繰り返して返す。

times が 1 未満の場合は、空の文字列が返される。

例

QString str("ab");
str.repeated(4);            // returns "abababab"

QString &QString::replace(qsizetype position, qsizetype n, const QString &after)

インデックスposition で始まるn 文字を文字列after で置き換え、この文字列への参照を返す。

例

QString x = "Say yes!";
QString y = "no";
x.replace(4, 3, y);
// x == "Say no!"

insert() およびremove()も参照のこと 。

QString &QString::replace(const QRegularExpression &re, const QString &after)

この関数は replace() をオーバーロードする。

文字列中の正規表現re をafter で置き換えます。文字列への参照を返します。例えば

QString s = "Banana";
s.replace(QRegularExpression("a[mn]"), "ox");
// s == "Boxoxa"

例: キャプチャグループを含む正規表現では、after に出現する ˶1 ,˶2,... は、対応するキャプチャグループによってキャプチャされた文字列に置換されます。

QString t = "A <i>bon mot</i>.";
t.replace(QRegularExpression("<i>([^<]*)</i>"), "\\emph{\\1}");
// t == "A \\emph{bon mot}."

indexOf()、lastIndexOf()、remove()、QRegularExpression 、およびQRegularExpressionMatchも参照してください 。

QString &QString::replace(QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

出現する文字before をすべて文字after で置き換え、この文字列への参照を返す。

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

QString &QString::replace(QChar c, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

出現する文字c をすべて文字列after で置き換え、この文字列への参照を返す。

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

QString &QString::replace(QChar ch, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

文字列中の文字ch をafter で置き換え、この文字列への参照を返す。

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

QString &QString::replace(QLatin1StringView before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

この文字列内の、before で表示される Latin-1 文字列を、after で表示される Latin-1 文字列で置換し、この文字列への参照を返します。

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

QString &QString::replace(QLatin1StringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

この文字列内の、before で表示される Latin-1 文字列のすべての出現回数を、文字列after で置き換え、この文字列への参照を返します。

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

QString &QString::replace(const QString &before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

文字列before のすべての出現箇所を文字列after で置き換え、この文字列への参照を返す。

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

QString &QString::replace(const QString &before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

この関数は replace() をオーバーロードする。

文字列before のすべての出現箇所を文字列after で置き換え、この文字列への参照を返す。

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

例

QString str = "colour behaviour flavour neighbour";
str.replace(QString("ou"), QString("o"));
// str == "color behavior flavor neighbor"

例

QString equis = "xxxxxx";
equis.replace("xx", "x");
// equis == "xxx"

QString &QString::replace(qsizetype position, qsizetype n, QChar after)

この関数は replace() をオーバーロードする。

インデックスposition で始まるn 文字をafter 文字で置き換え、この文字列への参照を返す。

QString &QString::replace(qsizetype position, qsizetype n, const QChar *after, qsizetype alen)