QStringList 类

成员函数文档

返回str在列表中第一次匹配的索引位置，从索引位置from开始向前搜索。如果未找到匹配项，返回 -1。

如果cs是Qt::CaseSensitive（默认值），则字符串比较区分大小写；否则比较不区分大小写。

另请参阅：lastIndexOf()。

返回列表中 str 最后匹配项的索引位置，从索引位置 from 向后搜索。如果 from 即为 -1（默认值），则从最后一个条目开始搜索。如果没有匹配的条目，则返回 -1。

如果cs是Qt::CaseSensitive（默认值），则字符串比较区分大小写；否则比较不区分大小写。

请参阅：indexOf()

QStringList::QStringList(const QString &str)

创建一个包含指定字符串 str 的字符串列表。可以通过这种方式轻松创建更长的列表

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

请参阅：append()

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

创建 other 的副本。

此操作的时间复杂度为 常数时间，因为 QStringList 是 隐式共享。这使得从函数中返回 QStringList 非常快。如果共享实例被修改，它将被复制（写时复制），这个过程的时间复杂度为 线性时间。

请参阅：operator=()

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;
    }

también consulte contains().

[desde 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 中引入。

también consulte contains().

[desde 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

这是一个重载的功能。

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

这是一个重载的功能。

返回与正则表达式 re 匹配的所有字符串列表。

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

这是一个重载的功能。

返回列表中 re 第一个完全匹配的位置索引，从索引位置 from 开始搜索。如果没有项目匹配，则返回 -1。

另请参阅：lastIndexOf()。

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

将字符串列表的所有字符串连接为一个单独的字符串，每个元素由给定的 separator 分隔（可以是空字符串）。

also see QString::split().

QString QStringList::join(QStringView separator) const

这是一个重载的功能。

QString QStringList::join(QLatin1StringView separator) const

This function overloads join().

qchar.html#QChar QStringList::join(QChar separator) const

This function overloads join().

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文本替换为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(QStringView before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

这是一个重载的功能。

QStringList &QStringList::replaceInStrings(const QString &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 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"]

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

按升序对字符串列表进行排序。

如果cs是Qt::CaseSensitive（默认值），则字符串比较区分大小写；否则比较不区分大小写。

排序是使用STL的std::sort()算法完成的，该算法平均为线性对数时间，即O(n log n)。

如果您想按任意顺序对字符串进行排序，请考虑使用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 QStringList &other)

这是一个重载的功能。

将 other 字符串列表追加到字符串列表中，并返回后者的引用。

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

这是一个重载的功能。

将 other 字符串列表追加到字符串列表中，并返回后者的引用。

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

从 QList<QString> 复制的赋值运算符。将 other 的字符串列表赋值给此字符串列表。

操作后，other 和 *this 将相等。

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

这是一个重载的功能。

从 QList<QString> 复制的赋值运算符。将 other 的字符串列表移动到此字符串列表。

操作后，other 将为空。