class QRegularExpressionMatchIterator#

QRegularExpressionMatchIterator类提供对字符串全局匹配QRegularExpression对象的迭代器。更多...

概要#

方法#

def __init__()
def hasNext()
def isValid()
def matchOptions()
def matchType()
def next()
def peekNext()
定义 regularExpression()
定义 swap()

注意

本文档可能包含从C++到Python自动翻译的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译存在问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们

详细描述#

警告

本节包含自动从C++翻译到Python的片段，可能包含错误。

QRegularExpressionMatchIterator对象是一个单向Java样式的迭代器；可以通过调用globalMatch()函数来获取。一个新的QRegularExpressionMatchIterator将被定位在第一个结果之前。然后，您可以调用hasNext()函数来检查是否有更多的结果可用；如果有，则next()函数将返回下一个结果并向前移动迭代器。

每个结果都是一个QRegularExpressionMatch对象，其中包含有关该结果的全部信息（包括捕获的子串）。

例如

# extracts the words
re = QRegularExpression("(\\w+)")
subject = QString("the quick fox")
i = re.globalMatch(subject)
while i.hasNext():
    match = i.next()
    # ...

此外，QRegularExpressionMatchIterator提供了一个peekNext()函数来获取下一个结果，但不移动迭代器。

从Qt 6.0开始，也可以在基于范围的for循环中简单地使用globalMatch的结果，例如

# using a raw string literal, R"(raw_characters)", to be able to use "\w"
# without having to escape the backslash as "\\w"
re = QRegularExpression(R"(\w+)")
subject = QString("the quick fox")
for match in re.globalMatch(subject):
    # ...

您可以通过调用regularExpression()函数来检索主题字符串所匹配的QRegularExpression对象；通过调用matchType()和matchOptions()分别获得匹配类型和匹配选项。

请参阅有关 Qt 正则表达式类的更多信息，请参阅 QRegularExpression 文档。

另见

QRegularExpression QRegularExpressionMatch

__init__()#

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

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

__init__(iterator)

参数): iterator – QRegularExpressionMatchIterator

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

另见

operator=()

hasNext()#

返回类型): bool

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

另见

next()

isValid()#

返回类型): bool

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

另见

globalMatch() isValid()

matchOptions()#

返回类型): MatchOption 的组合

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

另见

globalMatch() regularExpression() matchType()

matchType()#

返回类型): MatchType（匹配类型）

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

另见

globalMatch() regularExpression() matchOptions()

next()#

返回类型): Q正则表达式匹配

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

注意

当迭代器位于结果集的末尾时调用此函数会导致未定义的结果。

peekNext()#

返回类型): Q正则表达式匹配

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

注意

当迭代器位于结果集的末尾时调用此函数会导致未定义的结果。

regularExpression()#

返回类型): Q正则表达式

返回其globalMatch函数返回此对象的QRegularExpression对象。

另见

globalMatch() matchType() matchOptions()

swap(other)

参数): other – QRegularExpressionMatchIterator

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