Qt - QRegularExpression、QRegularExpressionMatch、QRegularExpressionMatchIterator 正则表达式

概述

比QRegExp好用的正则表达式类

• 验证：正则表达式可以测试子字符串是否符合某些标准。
• 搜索：一个正则表达式提供了比简单的子字符串匹配更强大的模式匹配。
• 搜索和替换：正则表达式可以用不同的子串替换所有出现的子串。
• 字符串拆分：正则表达式可用于识别字符串应在何处拆分。

QRegularExpression re("(\\d+)(?:\\s*)(cm|inch)");//小括号内带?:前缀，指只匹配不捕获，等价于"(\\d+)\\s*(cm|inch)"

QRegularExpressionMatch match = re.match("Length: 189cm 122cm");
qDebug() << match.hasMatch(); // true
qDebug() << match.capturedTexts(); // ("189cm", "189", "cm")
qDebug() << match.captured(0) << match.capturedStart(0) << match.capturedEnd(0); // "189cm"
qDebug() << match.captured(1) << match.capturedStart(1) << match.capturedEnd(1); // "189"
qDebug() << match.captured(2) << match.capturedStart(2) << match.capturedEnd(2); // "cm"


QRegularExpressionMatchIterator i = re.globalMatch("Length: 189cm 123cm");
while (i.hasNext())
{
    QRegularExpressionMatch match = i.next();
    qDebug() << match.capturedTexts();
}

QRegularExpression

match()
函数的结果是一个 QRegularExpressionMatch 对象，可用于检查匹配结果

bool isValid()
是否是有效表达式

QRegularExpressionMatch

QString captured(int nth = 0)
返回第 n 个捕获组捕获的子字符串。

QRegularExpression re("(\\d+)(?:\\s*)(cm|inch)");//小括号内带?:前缀，指只匹配不捕获，等价于"(\\d+)\\s*(cm|inch)"
QRegularExpressionMatch match = re.match("Length: 189cm");
qDebug() << match.captured(0); // "189cm"
qDebug() << match.captured(1); // "189"
qDebug() << match.captured(2); // "cm"

QString captured(const QString &name)
返回名为 name 的捕获组捕获的子字符串。

QRegularExpression re("^(?<date>\\d\\d)/(?<month>\\d\\d)/(?<year>\\d\\d\\d\\d)$");
QRegularExpressionMatch match = re.match("01/11/2022");
if (match.hasMatch())  {
    qDebug() << match.captured("date"); // 01
    qDebug() << match.captured("month"); // 11
    qDebug() << match.captured("year"); // 2022
}

globalMatch()
查找给定正则表达式的所有匹配项，返回一个 QRegularExpressionMatchIterator，它是一个迭代器可用于迭代结果

qsizetype capturedLength(int nth = 0)
返回第 n 个捕获组捕获的子字符串的长度

captureStart() 和 captureEnd()
可以检索每个捕获的子字符串的开始和结束偏移量

bool hasCaptured(const QString &name)
名为 name 的捕获组在主题字符串中捕获了某些内容，则返回 true

bool hasCaptured(int nth)
第 n 个捕获组捕获了主题字符串中的某些内容，则返回 true，否则返回 false（或者如果没有这样的捕获组）。隐式捕获组号 0 捕获整个模式匹配的子字符串。

bool hasMatch()
正则表达式与主题字符串是否匹配。

bool hasPartialMatch()
正则表达式与主题字符串是否部分匹配。只有明确使用其中一种部分匹配类型的匹配才能产生部分匹配。尽管如此，如果这样的匹配完全成功，此函数将返回 false，而 hasMatch() 将返回 true。

QRegularExpressionMatchIterator

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

bool isValid()
迭代器对象是否作为对有效 QRegularExpression 对象调用的 QRegularExpression::globalMatch() 函数的结果获得的。

QRegularExpressionMatch next()
返回下一个匹配结果并将迭代器前进一个位置。当迭代器位于结果集的末尾时调用此函数会导致未定义的结果。

QRegularExpressionMatch peekNext()
在不移动迭代器的情况下返回下一个匹配结果。当迭代器位于结果集的末尾时调用此函数会导致未定义的结果。