QRegularExpressionMatchIterator 类

// extracts the words
QRegularExpression re("(\\w+)");
QString subject("the quick fox");
QRegularExpressionMatchIterator i = re.globalMatch(subject);
while (i.hasNext()) {
    QRegularExpressionMatch match = i.next();
    // ...
}

// using a raw string literal, R"(raw_characters)", to be able to use "\w"
// without having to escape the backslash as "\\w"
QRegularExpression re(R"(\w+)");
QString subject("the quick fox");
for (const QRegularExpressionMatch &match : re.globalMatch(subject)) {
    // ...
}

成员函数文档

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

构造一个空的有效QRegularExpressionMatchIterator对象。正则表达式被设置为默认构造的一个；匹配类型为QRegularExpression::NoMatch，匹配选项为QRegularExpression::NoMatchOption。

在构造对象上调用hasNext()成员函数将返回false，因为迭代器不是在有效的匹配序列上迭代。

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

构造一个QRegularExpressionMatchIterator对象，作为iterator的副本。

参见操作符=。

[noexcept, since 6.1] QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(QRegularExpressionMatchIterator &&iterator)

通过移动自iterator构造一个QRegularExpressionMatchIterator对象。

注意，自移动的QRegularExpressionMatchIterator只能被销毁或赋值。调用除了析构函数或赋值运算符之外的其他函数的效果是未定义的。

此函数自Qt 6.1开始引入。

参见操作符=。

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

销毁QRegularExpressionMatchIterator对象。

bool QRegularExpressionMatchIterator::hasNext() const

如果迭代器前面至少有一个匹配结果，则返回true；否则返回false。

参见next。

bool QRegularExpressionMatchIterator::isValid() const

如果迭代器对象是从在有效的QRegularExpression对象上调用QRegularExpression::globalMatch()函数的结果获得；如果QRegularExpression无效，则返回false。

参见QRegularExpression::globalMatch()和QRegularExpression::isValid。

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

返回获取此QRegularExpressionMatchIterator对象所使用的匹配选项，即传递给QRegularExpression::globalMatch()的匹配选项。

另请参阅QRegularExpression::globalMatch，regularExpression和matchType。

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

返回获取此QRegularExpressionMatchIterator对象所使用的匹配类型，即传递给QRegularExpression::globalMatch()的匹配类型。

另请参阅QRegularExpression::globalMatch，regularExpression和matchOptions。

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

返回下一个匹配结果并使迭代器向前移动一位。

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

返回下一个匹配结果而不移动迭代器。

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

返回QRegularExpression对象，其globalMatch()函数返回此对象。

另请参阅QRegularExpression::globalMatch，matchType和matchOptions。

[noexcept] void QRegularExpressionMatchIterator::swap(QRegularExpressionMatchIterator &other)

交换迭代器other与此迭代器对象。此操作非常快且永远不会失败。

QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(const QRegularExpressionMatchIterator &iterator)

将迭代器iterator赋值给此对象，并返回对副本的引用。

[noexcept] QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(QRegularExpressionMatchIterator &&iterator)

移动赋值将iterator移动到此对象中，并返回对结果的重引用。

请注意，已移动的QRegularExpressionMatchIterator只能被销毁或赋值。调用析构函数或赋值运算符之外的其他函数的效果是未定义的。