QStringList Class

メンバ関数ドキュメント

インデックス位置from から前方を検索し、リスト内で最初にマッチしたstr のインデックス位置を返す。マッチする項目がない場合は -1 を返す。

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

lastIndexOf()も参照 。

インデックス位置from から後方へ検索して、リスト内で最後にマッチしたstr のインデックス位置を返します。from が -1 (デフォルト) の場合、検索は最後の項目から始まります。一致する項目がない場合は -1 を返します。

cs がQt::CaseSensitive （デフォルト）の場合、文字列の比較では大文字と小文字が区別されます。

indexOf()も参照 。

QStringList::QStringList(const QList<QString> &other)

other のコピーを構築する。

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

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

QStringList::QStringList(const QString &str)

与えられた文字列str を含む文字列リストを構築します。長いリストは、このように簡単に作成できます：

    QStringList longerList = (QStringList() << str1 << str2 << str3);

append()も参照 。

QStringList::QStringList(QList<QString> &&other)

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

QList<QString> から移動して構築します。

構築に成功すると、other は空になります。

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

リストに文字列str が含まれていればtrue を返し、そうでなければfalse を返す。

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

indexOf()、lastIndexOf()、QString::contains()も参照 。

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

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

リストにstr で見た Latin-1 文字列が含まれていればtrue を返し、そうでなければfalse を返す。

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

indexOf()、lastIndexOf()、QString::contains()も参照 。

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

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

リストに文字列str が含まれている場合はtrue を返し、そうでない場合はfalse を返す。

cs がQt::CaseSensitive の場合（デフォルト）、文字列の比較では大文字と小文字が区別されます。

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

部分文字列str を含むすべての文字列のリストを返します。

cs がQt::CaseSensitive （デフォルト）の場合、文字列の比較では大文字と小文字が区別されます。

    QStringList list;
    list << "Bill Murray" << "John Doe" << "Bill Clinton";

    QStringList result;
    result = list.filter("Bill");
    // result: ["Bill Murray", "Bill Clinton"]

これは

    QStringList result;
    for (const auto &str : std::as_const(list)) {
        if (str.contains("Bill"))
            result += str;
    }

contains()も参照 。

QStringList QStringList::filter(const QRegularExpression &re) const

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

正規表現re にマッチするすべての文字列のリストを返す。

[since 6.7] QStringList QStringList::filter(const QStringMatcher &matcher) const

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

matcher にマッチした (つまりmatcher.indexIn() がインデックス >= 0 を返す) 文字列のリストを返します。

大きなリストや長い文字列を含むリストを検索する場合は、QStringMatcher を使った方が速いかもしれません (ベンチマークを取るのが一番です)。

例えば

    QStringList veryLongList;
    QStringMatcher matcher(u"Straße", Qt::CaseInsensitive);
    QStringList filtered = veryLongList.filter(matcher);

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

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

[since 6.7] QStringList QStringList::filter(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

QStringList QStringList::filter(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

qsizetype QStringList::indexOf(const QRegularExpression &re, qsizetype from = 0) const

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

インデックス位置from から前方に検索して、リスト内のre に最初に完全に一致する項目のインデックス位置を返します。一致する項目がない場合は -1 を返します。

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

QString QStringList::join(const QString &separator) const

文字列リストのすべての文字列を、指定したseparator (空文字列でもよい) で各要素が区切られた単一の文字列に結合します。

QString::split()も参照 。

QString QStringList::join(QChar separator) const

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

QString QStringList::join(QLatin1StringView separator) const

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

QString QStringList::join(QStringView separator) const

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

qsizetype QStringList::lastIndexOf(const QRegularExpression &re, qsizetype from = -1) const

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

インデックス位置from から後方に検索して、リスト内でre に最後に完全に一致したインデッ クス位置を返します。from が-1（デフォルト）の場合、検索は最後の項目から始まります。一致する項目がない場合は -1 を返します。

indexOf()も参照 。

qsizetype QStringList::removeDuplicates()

この関数は、リストから重複項目を削除します。項目をソートする必要はありません。元の順序を保持します。

削除された項目の数を返します。

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

after すべての文字列が、before のテキストからbefore のテキストに置換された文字列リストを返します。

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

それ以外の場合は大文字小文字を区別しない：

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings("a", "o");
    // list == ["olpho", "beto", "gommo", "epsilon"]

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

QStringList &QStringList::replaceInStrings(const QRegularExpression &re, const QString &after)

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

文字列リストの各文字列内に出現する正規表現re をafter で置き換えます。文字列リストへの参照を返します。

例えば

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings(QRegularExpression("^a"), "o");
    // list == ["olpha", "beta", "gamma", "epsilon"]

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

例えば

    QStringList list;
    list << "Bill Clinton" << "Murray, Bill";
    list.replaceInStrings(QRegularExpression("^(.*), (.*)$"), "\\2 \\1");
    // list == ["Bill Clinton", "Bill Murray"]

QStringList &QStringList::replaceInStrings(QStringView before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

QStringList &QStringList::replaceInStrings(QStringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

QStringList &QStringList::replaceInStrings(const QString &before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

void QStringList::sort(Qt::CaseSensitivity cs = Qt::CaseSensitive)

文字列のリストを昇順にソートする。

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

ソートはSTLのstd::sort()アルゴリズムで行われ、平均対数時間はO(nlogn)です。

文字列を任意の順序でソートしたい場合は、QMap クラスの使用を検討してください。たとえば、QMap<QString,QString> を使って大文字小文字を区別しない順序（たとえば、キーは文字列の小文字バージョン、値は文字列）を作ったり、QMap<int,QString> を使って整数インデックスで文字列をソートしたりすることができます。

QStringList QStringList::operator+(const QStringList &other) const

この文字列リストとother の文字列リストを連結した文字列リストを返す。

append()も参照のこと 。

QStringList &QStringList::operator<<(const QString &str)

与えられた文字列str をこの文字列リストに追加し、その文字列リストへの参照を返します。

append()も参照 。

QStringList &QStringList::operator<<(const QList<QString> &other)

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

文字列リストにother を追加し、後者の文字列リストへの参照を返します。

QStringList &QStringList::operator<<(const QStringList &other)

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

other の文字列リストを文字列リストに追加し、後者の文字列リストへの参照を返します。

QStringList &QStringList::operator=(const QList<QString> &other)

QList<QString> からのコピー代入演算子。other の文字列リストをこの文字列リストに代入する。

操作後、other と*this は等しくなる。

QStringList &QStringList::operator=(QList<QString> &&other)

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

移動代入演算子QList<QString>.other の文字列リストをこの文字列リストに移動する。

操作後、other は空になる。