QRegularExpressionMatch Class

成员函数文档

QRegularExpressionMatch::QRegularExpressionMatch()

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

该对象将通过hasMatch() 和hasPartialMatch() 成员函数报告没有匹配。

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

通过复制给定match 的结果来构造匹配结果。

另请参阅 operator=() 。

[noexcept, since 6.1] QRegularExpressionMatch::QRegularExpressionMatch(QRegularExpressionMatch &&match)

通过从给定的match 中移动结果来构造匹配结果。

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

此函数在 Qt 6.1 中引入。

另请参阅 operator=()。

[noexcept] QRegularExpressionMatch::~QRegularExpressionMatch()

破坏比赛结果。

QString QRegularExpressionMatch::captured(QAnyStringView name) const

返回名为name 的捕获组捕获的子字符串。

如果名为name 的捕获组没有捕获字符串，或者没有名为name 的捕获组，则返回空值QString 。

另请参阅 capturedView(),capturedStart(),capturedEnd(),capturedLength() 和QString::isNull().

QString QRegularExpressionMatch::captured(int nth = 0) const

返回nth 捕捉组捕获的子字符串。

如果nth 捕捉组没有捕获字符串，或没有捕获组，则返回空QString 。

另请参阅 capturedView()、lastCapturedIndex()、capturedStart()、capturedEnd()、capturedLength() 和QString::isNull() 。

qsizetype QRegularExpressionMatch::capturedEnd(QAnyStringView name) const

返回主题字符串中紧随名为name 的捕获组捕获的子字符串结束位置之后的偏移量。如果名为name 的捕获组未捕获字符串或不存在，则返回 -1。

另请参阅 capturedStart()、capturedLength() 和captured()。

qsizetype QRegularExpressionMatch::capturedEnd(int nth = 0) const

返回nth 捕捉组捕获的子字符串结束位置后紧接主题字符串内部的偏移量。如果nth 捕捉组没有捕获字符串或不存在，则返回-1。

另请参阅 capturedStart()、capturedLength() 和captured()。

qsizetype QRegularExpressionMatch::capturedLength(QAnyStringView name) const

返回名为name 的捕获组捕获的子字符串的长度。

另请参阅 capturedStart()、capturedEnd() 和captured()。

qsizetype QRegularExpressionMatch::capturedLength(int nth = 0) const

返回nth 捕捉组捕获的子字符串的长度。

另请参阅 capturedStart()、capturedEnd() 和captured()。

qsizetype QRegularExpressionMatch::capturedStart(QAnyStringView name) const

返回主题字符串中与名为name 的捕获组捕获的子字符串起始位置相对应的偏移量。如果名为name 的捕获组未捕获字符串或不存在，则返回 -1。

另请参阅 capturedEnd()、capturedLength() 和captured()。

qsizetype QRegularExpressionMatch::capturedStart(int nth = 0) const

返回主题字符串中与nth 捕捉组捕获的子字符串起始位置相对应的偏移量。如果nth 捕捉组没有捕获字符串或不存在，则返回-1。

另请参阅 capturedEnd()、capturedLength() 和captured()。

QStringList QRegularExpressionMatch::capturedTexts() const

返回捕获组捕获的所有字符串的列表，按捕获组在模式字符串中出现的顺序排列。该列表包括隐式捕获组 0，捕获与整个模式匹配的子字符串。

QStringView QRegularExpressionMatch::capturedView(QAnyStringView name) const

返回名为name 的捕获组捕获的字符串的视图。

如果名为name 的捕获组没有捕获字符串，或者没有名为name 的捕获组，则返回空值QStringView 。

另请参阅 captured(),capturedStart(),capturedEnd(),capturedLength() 和QStringView::isNull().

QStringView QRegularExpressionMatch::capturedView(int nth = 0) const

返回nth 捕捉组捕获的子字符串的视图。

如果nth 捕捉组没有捕获字符串，或没有捕获组，则返回空QStringView 。

另请参阅 captured()、lastCapturedIndex()、capturedStart()、capturedEnd()、capturedLength() 和QStringView::isNull() 。

[since 6.3] bool QRegularExpressionMatch::hasCaptured(QAnyStringView name) const

如果名为name 的捕获组捕获了主题字符串中的内容，则返回 true，否则返回 false（或者如果没有名为name 的捕获组）。

QRegularExpressionre("([a-z]+)|([A-Z]+)");QRegularExpressionMatchm=re.match("UPPERCASE");if(m.hasMatch()) {    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

同样，捕获组可以捕获长度为 0 的子串；对于这样的捕获组，该函数将返回true 。

此函数在 Qt 6.3 中引入。

另请参阅 captured() 和hasMatch()。

[since 6.3] bool QRegularExpressionMatch::hasCaptured(int nth) const

如果nth 捕捉组捕捉到了主题字符串中的内容，则返回 true，否则返回 false（或者没有捕捉组）。

QRegularExpressionre("([a-z]+)|([A-Z]+)");QRegularExpressionMatchm=re.match("UPPERCASE");if(m.hasMatch()) {    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

同样，捕获组可以捕获长度为 0 的子串；对于这样的捕获组，该函数将返回true 。

此函数在 Qt 6.3 中引入。

另请参阅 captured()、lastCapturedIndex() 和hasMatch()。

bool QRegularExpressionMatch::hasMatch() const

如果正则表达式与主题字符串匹配，则返回true ，否则返回 false。

另请参阅 QRegularExpression::match() 和hasPartialMatch()。

bool QRegularExpressionMatch::hasPartialMatch() const

如果正则表达式与主题字符串部分匹配，则返回true ，否则返回 false。

另请参阅 QRegularExpression::match(),QRegularExpression::MatchType, 和hasMatch().

bool QRegularExpressionMatch::isValid() const

如果匹配对象是在有效的QRegularExpression 对象上调用QRegularExpression::match() 函数的结果，则返回true ；如果QRegularExpression 无效，则返回false 。

另请参阅 QRegularExpression::match() 和QRegularExpression::isValid()。

int QRegularExpressionMatch::lastCapturedIndex() const

返回最后捕获的捕获分组的索引，包括隐式捕获分组 0。 这可用于提取所有被捕获的子字符串：

QRegularExpressionMatch match = re.match(string);
for (int i = 0; i <= match.lastCapturedIndex(); ++i) {
    QString captured = match.captured(i);
    // ...
}

请注意，一些索引小于 lastCapturedIndex() 的捕获组可能没有匹配，因此捕获不到任何内容。

如果正则表达式不匹配，该函数将返回-1。

另请参见 hasCaptured()、captured()、capturedStart()、capturedEnd() 和capturedLength()。

QRegularExpression::MatchOptions QRegularExpressionMatch::matchOptions() const

返回用于获取QRegularExpressionMatch 对象的匹配选项，即传递给QRegularExpression::match() 或QRegularExpression::globalMatch() 的匹配选项。

另请参阅 QRegularExpression::match()、regularExpression() 和matchType()。

QRegularExpression::MatchType QRegularExpressionMatch::matchType() const

返回用于获取QRegularExpressionMatch 对象的匹配类型，即传递给QRegularExpression::match() 或QRegularExpression::globalMatch() 的匹配类型。

另请参阅 QRegularExpression::match()、regularExpression() 和matchOptions()。

QRegularExpression QRegularExpressionMatch::regularExpression() const

返回匹配()函数返回此对象的QRegularExpression 对象。

另请参阅 QRegularExpression::match()、matchType() 和matchOptions()。

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

将匹配结果与other 互换。该操作速度非常快，从未出现过故障。

[noexcept] QRegularExpressionMatch &QRegularExpressionMatch::operator=(QRegularExpressionMatch &&match)

Move 将匹配结果match 赋值给该对象，并返回该结果的引用。

请注意，moved-fromQRegularExpressionMatch 只能被销毁或赋值。调用析构函数或赋值操作符之外的其他函数的效果是未定义的。

QRegularExpressionMatch &QRegularExpressionMatch::operator=(const QRegularExpressionMatch &match)

将匹配结果match 赋值给此对象，并返回对副本的引用。