QStringList Class

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

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> からの Move 構文。

構築が成功すると、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 （デフォルト）の場合、文字列の比較は大文字と小文字を区別します。それ以外の場合は、大文字と小文字を区別しません。

[since 6.9] QStringList QStringList::filter(const QLatin1StringMatcher &matcher) const

matcher に一致するすべての文字列のリストを返します（つまり、matcher.indexIn() が 0 以上のインデックスを返すもの）。

大規模なリストや、長い文字列を含むリストを検索する場合、QLatin1StringMatcher を使用する方が高速になる可能性があります（確認するにはベンチマークを行うのが最善です）。

例：

    QStringList veryLargeList;
    QLatin1StringMatcher matcher("Street"_L1, Qt::CaseInsensitive);
    QStringList filtered = veryLargeList.filter(matcher);

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

contains() およびfilter(const QStringMatcher &)も参照してください 。

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() およびfilter(const QLatin1StringMatcher &)も参照してください 。

[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

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

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

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

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

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

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

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

文字列リストに含まれるすべての文字列を、指定されたseparator （空文字列でも可）で各要素を区切って、1つの文字列に結合します。

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

QString QStringList::join(QChar separator) const

QString QStringList::join(QLatin1StringView separator) const

QString QStringList::join(QStringView separator) const

リスト内で `str ` に一致する最後の要素のインデックス位置を、インデックス位置 `from` から逆方向に検索して返します。from が -1（デフォルト）の場合、検索は最後の要素から開始されます。一致する要素がない場合は -1 を返します。

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

「indexOf()」も参照してください 。

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)

各文字列において、before というテキストが見つかる箇所すべてで、before というテキストがafter というテキストに置き換えられた文字列のリストを返します。

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"]

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

例：

    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 は空になります。