Flutter正则表达式构建插件verbal_expressions的使用

简介

verbal_expressions 是一个帮助 Dart 开发者构建复杂正则表达式的库。它通过提供一系列链式调用的方法，使得正则表达式的构建更加直观和易读。

官方资源

• Dart 包信息
• GitHub 仓库

快速开始

安装

在 pubspec.yaml 文件中添加依赖：

dependencies:
  verbal_expressions: ^2.0.0

然后运行 flutter pub get 或 dart pub get 来安装依赖。

基本用法

构建和测试正则表达式

以下是一个简单的示例，用于匹配 URL：

import 'package:verbal_expressions/verbal_expressions.dart';

void main() {
  // 构建正则表达式
  var regex = VerbalExpression()
    ..startOfLine()
    ..then("http").maybe("s")
    ..then("://")
    ..maybe("www.")
    ..anythingBut(" ")
    ..endOfLine();

  // 创建一个示例 URL
  String url = "https://www.google.com";

  // 使用 VerbalExpression 的 hasMatch 方法测试字符串是否匹配正则表达式
  bool isMatch = regex.hasMatch(url); // true

  // 输出正则表达式
  print(regex.toString()); // ^http(s)?\:\/\/(www\.)?([^\\ ]*)$
}

多个条件匹配

以下示例展示了如何使用 or 方法来匹配多个条件：

import 'package:verbal_expressions/verbal_expressions.dart';

void main() {
  // 构建正则表达式
  var regex = VerbalExpression()
    ..startOfLine()
    ..then("abc")
    ..or("def");

  // 测试字符串
  String testString = "defzzz";

  // 使用 VerbalExpression 的 hasMatch 方法测试字符串是否匹配正则表达式
  bool isMatch = regex.hasMatch(testString); // true
}

预定义字符组

verbal_expressions 提供了一些预定义的字符组，方便快速构建正则表达式：

import 'package:verbal_expressions/verbal_expressions.dart';

void main() {
  // 构建正则表达式
  var regex = VerbalExpression()
    ..wordChar()
    ..nonWordChar()
    ..space()
    ..nonSpace()
    ..digit()
    ..nonDigit();

  // 输出正则表达式
  print(regex.toString()); // \w\W\s\S\d\D
}

捕获组

以下示例展示了如何定义捕获组并提取匹配结果：

import 'package:verbal_expressions/verbal_expressions.dart';

void main() {
  // 构建正则表达式
  var expression = VerbalExpression()
    ..find("a")
    ..beginCapture()
    ..find("b")
    ..anything()
    ..endCapture()
    ..then("cd");

  // 转换为 RegExp
  RegExp regex = expression.toRegExp();

  // 测试字符串
  String text = "abcd";

  // 获取匹配结果
  var match = regex.firstMatch(text);
  print(match.group(0)); // abcd
  print(match.group(1)); // b
}

更多示例

匹配电话号码

以下示例展示了如何匹配不同格式的电话号码：

import 'package:verbal_expressions/verbal_expressions.dart';

bool matchTelephoneNumber(String number) {
  final regex = VerbalExpression()
    ..startOfLine()
    ..then('+')
    ..beginCapture()
    ..range(['0', '9'])
    ..count(3)
    ..maybe('-')
    ..maybe(' ')
    ..endCapture()
    ..count(3)
    ..endOfLine();

  return regex.hasMatch(number);
}

void main() {
  const phoneWithSpace = '+097 234 243';
  print(matchTelephoneNumber(phoneWithSpace)); // true

  const phoneWithoutSpace = '+097234243';
  print(matchTelephoneNumber(phoneWithoutSpace)); // true

  const phoneWithDash = '+097-234-243';
  print(matchTelephoneNumber(phoneWithDash)); // true
}

提取域名

以下示例展示了如何从 URL 中提取域名：

import 'package:verbal_expressions/verbal_expressions.dart';

String getDomain(String url) {
  final expression = VerbalExpression()
    ..startOfLine()
    ..then('http')
    ..maybe('s')
    ..then('://')
    ..maybe('www.')
    ..anythingBut(' ')
    ..beginCapture()
    ..then('.')
    ..anythingBut('/')
    ..endCapture()
    ..anything()
    ..endOfLine();

  return expression.toRegExp().firstMatch(url)?.group(1) ?? '';
}

void main() {
  String domain = getDomain('https://www.google.com');
  print(domain); // .com

  domain = getDomain('http://ru.wikipedia.org/wiki/Dart');
  print(domain); // .org
}

替换文本

以下示例展示了如何使用 verbal_expressions 进行文本替换：

import 'package:verbal_expressions/verbal_expressions.dart';

void main() {
  final expression = VerbalExpression()
    ..find('dog')
    ..stopAtFirst()
    ..withAnyCase();

  final testString = expression.replace(
      'Replace first DoG in the sentence but do not touch second dog', 'cat');

  // Replace first cat in the sentence but do not touch second dog
  print(testString);
}

特性和问题

• 请在 GitHub 问题跟踪器 中查看功能请求和问题报告。

其他实现

verbal_expressions 在其他编程语言中的实现可以在这里找到：

• JavaScript
• PHP
• Python
• C#
• Objective-C
• Ruby
• Groovy
• Haskell
• C++

更多实现可以在 VerbalExpressions.github.io 查看。