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()も参照 。

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

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

ヌル文字列を構築します。ヌル文字列も空文字列とみなされます。

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は文字列データのディープコピーを作成します。unicode データはそのままコピーされ、Byte Order Mark がある場合は保持されます。

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

QString::QString(qsizetype size, QChar ch)

すべての文字がch に設定された、指定されたsize の文字列を構築します。

fill()も参照 。

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

other のコピーを構築する。

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

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 、すなわち%1 、%2 、...、%99 で表示される Latin-1 文字列で、最下位の番号のプレースマーカーを置き換えたこの文字列のコピーを返します。

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 を置き換える。

arg()をasprintf()よりも使用する利点の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

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

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 を使用して、this とs との比較を実行します。

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

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

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

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() をオーバーロードしたものである。

この文字列内の文字列ビューstr の（重複する可能性のある）出現回数を返す。

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

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

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

QString::const_reverse_iterator QString::crbegin() const

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

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

QString::const_reverse_iterator QString::crend() const

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

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

QChar *QString::data()

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

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

例

QString str = "Hello world";
QChar *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 文字列のコピーを返します。指定された文字列は UCS-4 でエンコードされているものとし、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 (ISO-10646-UCS-4 エンコード) の最初のsize 文字で初期化されたQString を返します。

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

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'-terminated でなければなりません。

この関数は、バイトオーダーマーク（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 string のエンコーディングは wchar のサイズに依存します。wcharが4バイトの場合、 はUCS-4として解釈され、wcharが2バイトの場合はUTF-16として解釈される。string

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

インデックス位置from から前方を検索して、この文字列内で最初に出現する文字列str のインデックス位置を返します。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 より小さい、等しい、または大きい場合に、0 より小さい、等しい、または大きい整数を返す。

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

compare()、QLocale 、Comparing Stringsも参照 。

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

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

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

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

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)

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

基数はデフォルトで 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 を表す文字列を返します。

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

指数を含む書式では、指数は符号を示し、少なくとも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() をオーバーロードする。

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

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

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

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

QString &QString::replace(const QChar *before, qsizetype blen, const QChar *after, qsizetype alen, Qt::CaseSensitivity cs = Qt::CaseSensitive)