QRegularExpressionMatch Class

成员函数文档

QRegularExpressionMatch::QRegularExpressionMatch()

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

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

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

通过复制给定的match 的结果来构建一个匹配结果。

另请参阅 operator=()。

[constexpr noexcept default, 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 的捕获组，也返回false）。

QRegularExpression re("([a-z]+)|([A-Z]+)");
QRegularExpressionMatch m=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。

QRegularExpression re("([a-z]+)|([A-Z]+)");
QRegularExpressionMatch m=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

返回其 match() 函数返回了此对象的QRegularExpression 对象。

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

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

将本场比赛的结果与other 互换。此操作速度极快，且绝不会失败。

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

将匹配结果 `match ` 通过移动赋值操作赋值给该对象，并返回该结果的引用。

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

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

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