Qt C++ ：QRegularExpression 正则表达式使用详解

文章目录

• QRegularExpression类
• • 基本用法示例
  • 常用选项（Pattern Options）
  • 性能建议
  • 常见应用场景
• 正则表达式
• • 基本字符与字面量
  • 元字符（Metacharacters）
  • 字符类（Character Classes）
  • 量词（Quantifiers）
  • 分组与捕获（Grouping & Capturing）
  • 边界与断言（Assertions）
  • 修饰符 / 标志（Flags）
  • 特殊结构
• 总结

QRegularExpression类

Qt5.0引入，用于解析正则表达式的类 基于 PCRE2（Perl Compatible Regular Expressions） 功能强大、性能好、支持 Unicode 是现代 Qt 应用的首选

基本用法示例

1. 匹配字符串是否符合模式

#include <QRegularExpression>
#include <QDebug>

QString email = "user@example.com";
QRegularExpression re(R"(^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$)");
QRegularExpressionMatch match = re.match(email);

if (match.hasMatch()) {
qDebug() << "Valid email!";
}

注意：使用原始字符串字面量 R"(…)" 避免反斜杠转义问题。

R"(…)" 是 C++11 引入的原始字符串字面量（Raw String Literal） 语法，不是 Qt 特有的，而是标准 C++ 的特性。它常被 Qt 开发者用于书写正则表达式、文件路径、SQL 语句等包含大量反斜杠 \\ 或引号的字符串，以避免繁琐的转义。

2. 提取捕获组（Capturing Groups）

QString text = "Date: 2026-01-01";
QRegularExpression re(R"(Date: (\\d{4})-(\\d{2})-(\\d{2}))");
QRegularExpressionMatch match = re.match(text);

if (match.hasMatch()) {
QString year = match.captured(1); // "2026"
QString month = match.captured(2); // "01"
QString day = match.captured(3); // "01"
}

• captured(0) 是整个匹配
• captured(n) 是第 n 个括号内的内容

3. 全局查找所有匹配项

QString text = "cat dog cat bird";
QRegularExpression re("cat");
QRegularExpressionMatchIterator it = re.globalMatch(text);

while (it.hasNext()) {
QRegularExpressionMatch match = it.next();
qDebug() << "Found at position:" << match.capturedStart();
}

4. 替换文本

QString text = "Hello 123 World 456";
QRegularExpression re("\\\\d+");
QString result = re.replace(text, "NUM");
// 结果: "Hello NUM World NUM"

支持使用捕获组进行替换：

QString text = "John Doe";
QRegularExpression re("(\\\\w+) (\\\\w+)");
QString result = re.replace(text, "\\\\2, \\\\1");
// 结果: "Doe, John"

常用选项（Pattern Options）

通过 QRegularExpression::setPatternOptions() 或构造时传入选项：

QRegularExpression re("hello", QRegularExpression::CaseInsensitiveOption);

常用选项：

• CaseInsensitiveOption：忽略大小写
• DotMatchesEverythingOption：. 匹配包括换行符
• MultilineOption：^ 和 $ 匹配每行开头结尾
• ExtendedPatternSyntaxOption：允许正则中加注释和空白（类似 Perl 的 /x）

性能建议

• 预编译正则表达式：避免在循环中重复构造 QRegularExpression

• 使用 isValid() 检查合法性：

  if (!re.isValid()) {
  qDebug() << "Regex error:" << re.errorString();
  }

• 对于简单匹配（如固定字符串），优先考虑 QString::contains()、startsWith() 等，性能更高

常见应用场景

在 UI 输入验证中（如 QLineEdit + QValidator），可结合 QRegularExpressionValidator 使用：

QRegularExpression re("\\\\d{3}-\\\\d{2}-\\\\d{4}"); // 社保号格式
QRegularExpressionValidator *validator = new QRegularExpressionValidator(re, this);
lineEdit->setValidator(validator);

正则表达式

正则表达式（Regular Expression，简称 regex）是一种用于匹配、查找、替换文本的强大工具。其核心在于模式（pattern），而模式由各种符号（元字符、量词、分组、断言等）组成。以下是正则表达式中各组常用符号的详细定义与分类说明，适用于大多数现代正则引擎（包括 Qt 的 QRegularExpression，基于 PCRE2）。

基本字符与字面量

元字符（Metacharacters）

这些字符有特殊含义，若要匹配字面值，需用反斜杠转义：

字符类（Character Classes）

预定义字符类（Shorthand） 表格

Qt 的 QRegularExpression 默认启用 Unicode，因此 \\w 可能匹配中文、阿拉伯字母等（取决于上下文）。

量词（Quantifiers）

用于指定前面元素出现的次数。

贪婪 vs 懒惰（非贪婪）

• 默认是贪婪：尽可能多匹配
• 加 ? 变成懒惰：尽可能少匹配

示例：

<a>.*</a> // 贪婪：匹配整个 <a>…</a>…<a>…</a>
<a>.*?</a> // 懒惰：只匹配第一个 <a>…</a>

分组与捕获（Grouping & Capturing）

示例（Qt 中）：

QRegularExpression re(R"((\\d{4})-(\\d{2}))");
auto match = re.match("2026-01");
match.captured(1); // "2026"
match.captured(2); // "01"

命名组示例：

QRegularExpression re(R"((?<year>\\d{4})-(?<month>\\d{2}))");
auto match = re.match("2026-01");
match.captured("year"); // "2026"
match.captured("month"); // "01"

边界与断言（Assertions）

这些不消耗字符，只判断位置。

示例：

\\w+(?=;) // 匹配后面跟着分号的单词，但不包含分号
\\d{3}(?!\\d) // 匹配三位数，且后面不是数字（避免匹配 1234 中的 123）

修饰符 / 标志（Flags）

控制正则行为，可在模式中内联或通过 API 设置：

示例：

// Qt 中设置标志
QRegularExpression re(R"(\\d+)", QRegularExpression::CaseInsensitiveOption);

// 或在模式中内联
QRegularExpression re(R"((?i)hello)"); // 匹配 hello, Hello, HELLO 等

特殊结构

总结

• 使用 R"(…)" 避免 C++ 字符串转义
• 优先用 QRegularExpression（非 QRegExp）
• 用 captured(n) 或 captured(“name”) 提取内容
• 用 globalMatch() 遍历所有匹配