QtQRegularExpression正则类的使用小结

在Qt5的世界里，QRegularExpression可以说就是正则匹配的“一把手”。无论是字符串提取、格式校验，还是协议解析，它都是绕不开的核心工具。下面，咱们就来拆解一下它的核心用法。

1. 为什么要用 QRegularExpression？（历史背景）

直接说结论：Qt官方已经明确表态，新项目首选QRegularExpression，原因无他——性能更强、语法更通用。在Qt 5之前，Qt用的是老旧的QRegExp，但现在已经全面被新方案取代。

结论：在资源受限的嵌入式平台，正则匹配效率直接影响UI响应速度，QRegularExpression是唯一选择。

2. 核心类结构

简单来说，主要涉及三个类，它们分工明确：

• QRegularExpression：定义规则（Pattern），相当于正则表达式本身。
• QRegularExpressionMatch：存储单次匹配结果，包含捕获组等内容。
• QRegularExpressionMatchIterator：存储多次匹配结果，适合全局匹配场景。

3. 基础用法：匹配与捕获

3.1 简单匹配

先看一个最基础的例子：从视频分辨率字符串中提取宽高。

#include 
#include 

QString text = "Video Resolution: 1920x1080 @ 60Hz";
QRegularExpression re("(\d{4})x(\d{4})");

QRegularExpressionMatch match = re.match(text);
if (match.hasMatch()) {
    QString width = match.captured(1);  // "1920"
    QString height = match.captured(2); // "1080"
}

3.2 捕获组 (Capture Groups)

毫不夸张地说，在流媒体协议解析中，捕获组是最常用的功能之一。比如解析SDP或RTSP头时，用它提取字段非常高效。

• captured(0)：整个匹配的字符串。
• captured(1)：第一个括号里的内容，依此类推。

4. 高级特性

4.1 贪婪与非贪婪匹配

这个特性在处理不定长数据流时特别关键，稍不留神就可能匹配出问题。举一个处理XML/JSON片段的例子：

QString data = "";

// 贪婪匹配（默认）：会匹配到最后一个 
QRegularExpression greedyRe("");
// 非贪婪匹配：只匹配到第一个结束标签
QRegularExpression lazyRe("");

4.2 命名捕获（Named Capturing Groups）

这里必须重点推荐一个功能——命名捕获组。在协议解析中，它能极大提升代码可读性，而且不怕以后调整正则的顺序。来看一个解析RTSP地址的例子：

QRegularExpression re(
    "^(?\w+)://"
    "(?\d+\.\d+\.\d+\.\d+):"
    "(?\d+)$"
);

QRegularExpressionMatch match = re.match("rtsp://192.168.1.100:554");
if (match.hasMatch()) {
    qDebug() << "Type:" << match.captured("type"); // rtsp
    qDebug() << "IP:"   << match.captured("ip");   // 192.168.1.100
    qDebug() << "Port:" << match.captured("port"); // 554
}

这个技巧在解析RTSP/HTTP/SRT地址字符串时特别实用。

5. 全局匹配（Global Matching）

如果你需要从一段日志或NALU流中批量提取数据，全局匹配就是你的好帮手。比如从日志中提取所有包信息：

QString logData = "Pkt:123 Size:1500nPkt:124 Size:1450";
QRegularExpression re("Pkt:(\d+) Size:(\d+)");

QRegularExpressionMatchIterator it = re.globalMatch(logData);
while (it.hasNext()) {
    QRegularExpressionMatch match = it.next();
    qDebug() << "Packet" << match.captured(1) 
             << "Size" << match.captured(2);
}

6. 性能优化（针对嵌入式 Linux）

在嵌入式Linux环境下，正则表达式是典型的CPU密集型操作，性能优化必须提到日程上。这里重点提两条：

6.1 预编译

首要原则：不要在循环里反复创建QRegularExpression对象，那样每次都会重新编译正则，开销非常大。

// ❌ 错误示范：每次调用都会重新编译正则
void badParse(QString data) {
    QRegularExpression re("pattern"); // 开销大
    ...
}

// ✅ 正确做法：使用静态变量或成员变量
void goodParse(QString data) {
    static const QRegularExpression re("pattern"); // 只编译一次
    ...
}

6.2 设置匹配选项

适当设置匹配选项可以进一步提升效率，比如不捕获中间结果：

QRegularExpression re("pattern");
re.setPatternOptions(QRegularExpression::DotMatchesEverythingOption |
                    QRegularExpression::DontCaptureOption); // 不捕获提高效率

7. 在 Qt Widgets / 输入验证中的应用

实际开发中，经常需要对用户输入做合法性校验，比如IP地址、端口号。QRegularExpression结合QValidator可以轻松实现。

7.1 QLineEdit 输入校验

QLineEdit *ipInput = new QLineEdit(this);
QRegularExpression ipRegex(
    "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}"
    "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
);
QValidator *validator = new QRegularExpressionValidator(ipRegex, this);
ipInput->setValidator(validator);

总结

• 放弃 QRegExp，全面启用 QRegularExpression，这是新项目的标配。
• 善用命名捕获，让协议解析代码更易维护，谁用谁知道。
• 注意性能，把QRegularExpression对象定义为 static const或类成员，避免重复编译。
• 如果结合GStreamer调试，用正则过滤Pipeline日志能大幅提升排查效率。