QString Class

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

[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()も参照してください 。

[explicit, since 6.8] QString::QString(QStringView sv)

ストリングビューのデータで初期化された文字列を作成します。

sv がnullである場合に限り、QStringはnullになります。

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

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

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の場合、空の文字列が生成されます。

size が負の場合、unicode は '\0' で終了する配指し示しているとみなされ、その長さは動的に決定されます。終了文字であるヌル文字は、文字列の一部とはみなされません。

QString は、文字列データのディープコピーを作成します。Unicode データはそのままコピーされ、バイト順マーク (BOM) が存在する場合は保持されます。

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

QString::QString(qsizetype size, QChar ch)

指定されたsize の各文字をch に設定した文字列を生成します。

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

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

other のコピーを作成します。

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

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

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

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)

この文字列に「ch 」という文字を追加します。

QString &QString::append(QLatin1StringView str)

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

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

指定された文字列ビュー `v ` をこの文字列に追加し、その結果を返します。

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

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

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

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

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

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

アプリケーションのコンパイル時に `QT_NO_CAST_FROM_ASCII ` を定義することで、この関数を無効にすることができます。これは、たとえば、ユーザーに表示されるすべての文字列を `QObject::tr()` 経由で処理させたい場合などに役立ちます。

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

この文字列に「str 」という文字列を追加します。指定された const char ポインタは、fromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時に `QT_NO_CAST_FROM_ASCII ` を定義することで、この関数を無効にすることができます。これは、例えば、ユーザーに表示されるすべての文字列が `QObject::tr()` を経由するようにしたい場合などに役立ちます。

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

QChar 配列str に含まれるlen 文字を、この文字列に追加します。

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

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

Args QAnyStringView へ暗黙的に変換可能なものであれば何でも構成可能です。

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

template <typename T> requires if_string_like<T> QString QString::arg(const T &a, int fieldWidth = 0, QChar fillChar = u' ') const

この文字列のコピーを返し、番号が最も小さいプレースホルダーを文字列 `a` で置き換えます。つまり、`%1`、`%2`、……、`%99` となります。

fieldWidth a が占める最小のスペースを指定します。 が よりも少ないスペースしか必要としない場合、 文字で までパディングされます。正の を指定すると、テキストは右揃えになります。負の を指定すると、テキストは左揃えになります。a fieldWidth fillChar fieldWidth 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 の範囲でなければなりません。

template <typename T> requires if_integral_non_char<T> QString QString::arg(T a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

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も参照してください 。

template <typename T> requires if_floating_point<T> QString QString::arg(T a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

引数 `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 のサイズに相当し、v.toString() によって変換されたかのように UTF-16 に変換されます。ただし、QAnyStringView::toString() とは異なり、この関数は、推定サイズがこの文字列の容量を超える場合、またはこの文字列が共有されている場合にのみメモリを割り当てます。

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

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

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

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

この文字列のサイズは、範囲 [first,last) 内の要素のデコード後の長さと同じになります。この関数は入力文字セットを UTF-16 に透過的に再エンコードするため、この長さは範囲自体の長さとは必ずしも同じとは限りません。

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

制約

InputIterator がLegacyInputIteratorの要件を満たし、かつInputIterator のvalue_type が以下の文字型のいずれかである場合にのみ、オーバーロード解決の対象となります:

• 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

qsizetype QString::capacity() const

再割り当てを強制することなく、文字列に格納できる最大文字数を返します。

この関数の唯一の目的は、QString のメモリ使用量を微調整する手段を提供することです。一般的に、この関数を呼び出す必要はほとんどありません。文字列に含まれる文字数を知りたい場合は、size()を呼び出してください。

関連項目： reserve() およびsqueeze()。

QString::const_iterator QString::cbegin() const

文字列の先頭文字を指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびcend()。

QString::const_iterator QString::cend() const

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

関連項目： cbegin() およびend()。

void QString::chop(qsizetype n)

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

n がsize()以上の場合、結果は空文字列になります。n が負の値の場合、0を指定した場合と同じ結果になります。

例：

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

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

関連項目： truncate()、resize()、remove()、およびQStringView::chop()。

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

関連項目: endsWith()、first()、last()、sliced()、chop()、truncate()、およびslice()。

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

cs の大文字小文字の区別設定を使用して、これを `ch` と比較します。

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

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

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

cs の大文字小文字の区別設定を使用して、これを `s` と比較します。

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

この文字列と文字列 `other ` を辞書順で比較し、この文字列が `other` より小さい場合は負の整数を、`other` より大きい場合は正の整数を、等しい場合は 0 を返します。

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

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

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

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

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

大文字と小文字の区別設定（cs ）に基づいて、s1 とs2 の比較を行います。

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

QString::const_iterator QString::constBegin() const

文字列の先頭文字を指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびconstEnd()。

const QChar *QString::constData() const

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

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

関連項目: data()、operator[]()、およびfromRawData()。

QString::const_iterator QString::constEnd() const

文字列の最後の文字の直後の位置を指す、STL スタイルのconstイテレータを返します。

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

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

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

この文字列に latin-1 形式の文字列 `str` が含まれている場合は `true ` を返し、そうでない場合は `false` を返します。

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

この文字列に「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

正規表現 `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

文字列内の文字「ch 」の出現回数を返します。

cs が `Qt::CaseSensitive `（デフォルト）の場合、大文字と小文字を区別して検索します。それ以外の場合は、大文字と小文字を区別せずに検索します。

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

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

この文字列内で、文字列ビュー `str ` が（重複している場合も含め）何回出現するかを返します。

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

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

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

QString::const_reverse_iterator QString::crbegin() const

文字列の最初の文字を逆順で指す、STL スタイルのconst リバースイテレータを返します。

関連項目: ` begin()`、`rbegin()`、および `rend()`。

QString::const_reverse_iterator QString::crend() const

文字列の最後の文字の直後を指す、STL スタイルの逆順イテレータ（const）を、逆順で返します。

関連項目： 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()も参照してください 。

void QString::detach()

この文字列のデータが、他のインスタンスと共有されなくなるようにします。

QString::iterator QString::end()

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

関連項目: ` begin()` および `constEnd()`。

QString::const_iterator QString::end() const

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` を返します。

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

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

文字列の末尾が「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()も参照してください 。

この文字列の先頭から、n 文字分（つまり、この文字列の先頭から、インデックス位置n にある要素までは含まない）を含む文字列を返します。

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

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

関連項目： last()、sliced()、startsWith()、chopped()、chop()、truncate()、およびslice()。

[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)」エンコーディングを返すためですが、このエンコーディングは現代の Apple オペレーティングシステムでは使用すべきではありません。 Windows では、システムの現在のコードページが使用されます。

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

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

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

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

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

string のNSStringのコピーを含む新しいQString を生成します。

[static, since 6.10] QString QString::fromRawData(const char16_t *unicode, qsizetype size)

配列 `unicode` の先頭から `size ` 個の Unicode 文字を使用する `QString ` を生成します。`unicode ` 内のデータはコピーされません。呼び出し側は、QString （またはその変更されていないコピー）が存在する限り、unicode が削除または変更されないことを保証できなければなりません。

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

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

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

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

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

fromUtf16()、setRawData()、data()、constData()、nullTerminate()、およびnullTerminated()も参照してください 。

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

[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バイトの場合（Windowsなど）、utf16でエンコードされているものとみなされ、wchar_tのサイズが4バイトの場合（ほとんどのUnixシステム）、ucs4でエンコードされているものとみなされます。

関連項目: 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' で終了していなければなりません。

関連項目： 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 つ以上の「置換文字」に置き換えられるか、または抑制されます。 これには、非ユニコードシーケンス、非文字、長すぎるシーケンス、または 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

この文字列内で、str によって解釈されるLatin-1文字列が最初に現れるインデックス位置を、インデックス位置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の場合は最後から2番目の文字から開始される、というように続きます。

lastIndexOf()、contains()、count()も参照してください 。

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

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

一致に成功し、かつ `rmatch ` が `nullptr` ではない場合、一致の結果は `rmatch` が指す `QRegularExpressionMatch ` オブジェクトにも書き込まれます。

例：

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

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の場合は最後から2番目の文字から開始され、以下同様です。

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

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

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

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

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

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

from が -1 の場合、検索は最後の文字から開始されます。-2 の場合は最後から 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)

文字列内の指定されたインデックスposition の位置に、ch を挿入します。

この文字列は、挿入に合わせて長さが増加します。position が文字列の末尾を超えている場合、このposition に達するまでスペース文字が文字列に追加され、その後にch が続きます。

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

str によって認識されたLatin-1文字列を、指定されたインデックスposition の位置に挿入します。

この文字列は、挿入に合わせて長さが拡張されます。position が文字列の末尾を超えている場合、このposition に到達するまでスペース文字が文字列に追加され、その後にstr が追加されます。

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

指定されたインデックス `position ` の位置に文字列ビュー `str ` を挿入し、この文字列への参照を返します。

この文字列は、挿入に合わせて長さが拡張されます。position が文字列の末尾を超えている場合、position に到達するまでスペース文字が文字列に追加され、その後にstr が続きます。

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

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

指定されたインデックスposition に、UTF-8 文字列ビューstr を挿入します。

この文字列は、挿入に合わせて長さが増加します。position が文字列の末尾を超えている場合、このposition に到達するまでスペース文字が文字列に追加され、その後にstr が続きます。

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

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

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

この文字列は、挿入に合わせて長さが増加します。position が文字列の末尾を超えている場合、このposition に到達するまでスペース文字が文字列に追加され、その後にstr が続きます。

QT_NO_CAST_FROM_ASCII が定義されている場合、この関数は利用できません。

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

指定されたインデックス `position ` の位置に C 文字列 `str ` を挿入し、この文字列への参照を返します。

この文字列は、挿入に合わせて長さが拡張されます。position が文字列の末尾を超えている場合、position に達するまでスペース文字が文字列に追加され、その後にstr が続きます。

QT_NO_CAST_FROM_ASCII が定義されている場合、この関数は利用できません。

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

QChar 配列unicode の先頭からsize 文字分を、文字列内の指定されたインデックスposition の位置に挿入します。

この文字列は、挿入に対応するために長さが増加します。position が文字列の末尾を超えている場合、このposition に達するまでスペース文字が文字列に追加され、その後にQChar 配列unicode のsize 文字が続きます。

[constexpr 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()も参照してください 。

[constexpr] bool QString::isNull() const

この文字列がnullの場合はtrue を返し、それ以外の場合はfalse を返します。

例:

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

Qt XML では、歴史的な理由から、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 から正常にデコードできるかどうかを確認するだけです。データはホストバイト順であると仮定されます。BOM の有無は意味を持ちません。

QStringView::isValidUtf16()も参照してください 。

この文字列の末尾からn 文字分を含む文字列を返します。

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

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

関連項目： first()、sliced()、endsWith()、chopped()、chop()、truncate()、およびslice()。

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

文字列内で、正規表現 `re ` の最後の一致箇所（インデックス位置 `from` の直前から始まるもの）のインデックス位置を返します。

from が -1 の場合、検索は最後の文字から開始されます。-2 の場合は最後から 2 番目の文字から、というように続きます。

re がどこにも一致しなかった場合は -1 を返します。

一致に成功し、かつ `rmatch ` が `nullptr` ではない場合、一致の結果は `rmatch` が指す `QRegularExpressionMatch ` オブジェクトにも書き込まれます。

例：

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

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

この文字列内で、文字列「str 」が最後に現れる位置のインデックスを、インデックス位置「from 」から逆方向に検索して返します。

from が -1 の場合、検索は最後の文字から開始されます。-2 の場合は最後から 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

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

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

この文字列内で、文字列「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

この文字列内で、文字列 `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

文字列内で正規表現 `re ` の最後の一致箇所を示すインデックスを返します。re がどこにも一致しなかった場合は -1 を返します。

一致に成功し、かつ `rmatch ` が `nullptr` ではない場合、一致の結果は `rmatch` が指す `QRegularExpressionMatch ` オブジェクトにも書き込まれます。

例:

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

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

この文字列内で「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

この文字列内で、文字「ch 」が最後に現れる位置を、インデックス位置「from 」から逆方向に検索して返します。

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

この文字列内で、str によって認識されたLatin-1文字列が最後に現れたインデックス位置を、インデックス位置from から逆方向に検索して返します。

from が -1 の場合は最後の文字から、-2 の場合は最後から 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

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

from が -1 の場合、検索は最後の文字から開始されます。-2 の場合は最後から 2 番目の文字から開始され、以下同様です。

str が見つからない場合は -1 を返します。

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

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

この文字列のn 文字分（つまり、この文字列の先頭から、インデックス位置n にある要素まで（その要素自体は含まない））を含む部分文字列を返します。

n が範囲外になる可能性がないことが分かっている場合は、新しいコードではfirst() を使用してください。こちらの方が高速です。

n がsize() 以上、または 0 未満の場合、文字列全体が返されます。

first()、last()、startsWith()、chopped()、chop()、およびtruncate()も参照してください 。

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

width の長さの文字列を返します。この文字列には、fill 文字でパディングされた元の文字列が含まれます。

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()も参照してください 。

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

この文字列に含まれる文字数を返します。size() と同等です。

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

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

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

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

compare()、QLocale 、およびComparing Stringsも参照してください 。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

指定されたposition のインデックスから、インデックス位置にある要素まで（ただし、その要素自体は含まない）の範囲で、この文字列のn 文字を含む文字列を返します position + nまでの部分（ただし、その要素自体は含まない）を格納した文字列を返します。

position とn が範囲外になることがないことが分かっている場合は、新しいコードでは代わりにsliced() を使用してください。処理速度が速いからです。

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

関連項目： first()、last()、sliced()、chopped()、chop()、truncate()、およびslice()。

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

Unicode規格のversion に従い、指定されたUnicode正規化mode で文字列を返します。

[since 6.10] QString &QString::nullTerminate()

この文字列データがヌル終端されていない場合、このメソッドはデータのディープコピーを作成し、ヌル終端にします。

QString はデフォルトでヌル終端されていますが、場合によっては（例えばfromRawData()を使用する場合など）、文字列データが必ずしも\0 文字で終わるわけではないため、ヌル終端された文字列を期待するメソッドを呼び出す際に問題となる可能性があります。

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

nullTerminated()、fromRawData()、およびsetRawData()も参照してください 。

この文字列の、常にヌル文字で終了するコピーを返します。

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

nullTerminate()、fromRawData()、およびsetRawData()も参照してください 。

[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` を表す文字列を返します。

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

指数を含む形式の場合、指数には符号が表示され、少なくとも 2 桁になります。必要に応じて、指数は 0 で左詰めされます。

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)

この文字列の先頭に「ch 」という文字列を追加します。

QString &QString::prepend(QLatin1StringView str)

str で認識された Latin-1 文字列を、この文字列の先頭に追加します。

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

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

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

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

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

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

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

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

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザーに表示されるすべての文字列がQObject::tr()を経由するようにしたい場合などに役立ちます。

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

この文字列の先頭に「str 」という文字列を追加します。const char 型のポインタは、fromUtf8() 関数を使用して Unicode に変換されます。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_ASCII を定義することで、この関数を無効にすることができます。これは、例えば、ユーザーに表示されるすべての文字列がQObject::tr() を経由するようにしたい場合などに役立ちます。

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

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 という述語が true を返すすべての要素を文字列から削除します。文字列への参照を返します。

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

文字列内の正規表現 `re ` が現れる箇所をすべて `after` に置換します。文字列への参照を返します。例：

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

キャプチャグループを含む正規表現の場合、 \1, \2after, ..., といった出現箇所は、対応するキャプチャグループによってキャプチャされた文字列に置換されます。

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)

文字「before 」がすべて見つかるたびに、それを「after 」に置き換え、この文字列への参照を返します。

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

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

文字列「c 」がすべて出現する箇所を「after 」に置換し、この文字列への参照を返します。

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

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

文字列内の「ch 」という文字列をすべて「after 」に置き換え、この文字列への参照を返します。

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

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

before で解釈されるこの文字列内の Latin-1 文字列を、すべてafter で解釈される Latin-1 文字列に置換し、この文字列への参照を返します。

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

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

before で取得された Latin-1 文字列が、この文字列内に存在するすべての箇所を、after という文字列に置換し、この文字列への参照を返します。

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

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

文字列「before 」がすべて出現する箇所を「after 」に置き換え、この文字列への参照を返します。