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)

这是一个重载函数。

Move-construct 从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 （默认值），则字符串比较区分大小写；否则比较不区分大小写。

[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

这是一个重载函数。

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)

返回一个字符串列表，其中每个字符串中的before 文本都已替换为after 文本，只要找到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)

这是一个重载函数。

用after 替换正则表达式re 在字符串列表的每个字符串中的每一次出现。返回字符串列表的引用。

例如

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