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 分隔（该分隔符可以是空字符串）。

另请参阅 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

返回列表中re 的最后一个精确匹配项的索引位置，从索引位置from 开始向后搜索。如果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, \2after, ..., 将分别替换为由相应捕获组捕获的字符串。

例如：

    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 将变为空。