QRegularExpressionMatchIterator Class

// 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 的副本。

另请参阅 operator=()。

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

通过从iterator 移动数据来构建一个QRegularExpressionMatchIterator对象。

请注意，被移出的 QRegularExpressionMatchIterator 只能被销毁或进行赋值。调用除析构函数或赋值运算符之外的其他函数将产生未定义的行为。

该函数在 Qt 6.1 中引入。

另请参阅 operator=()。

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

销毁QRegularExpressionMatchIterator 对象。

bool QRegularExpressionMatchIterator::hasNext() const

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

另请参阅 next()。

bool QRegularExpressionMatchIterator::isValid() const

如果迭代器对象是通过在有效的QRegularExpression 对象上调用QRegularExpression::globalMatch()函数获得的，则返回true ；如果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 互换。此操作速度极快，且绝不会失败。

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

将iterator 通过移动赋值给该对象，并返回结果的引用。

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

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

将迭代器iterator 分配给该对象，并返回该副本的引用。