Flutter正则表达式转换插件regex_transformer的使用

Flutter正则表达式转换插件regex_transformer的使用

regex_transformer 是一个用于在 Dart 中对文本进行正则表达式转换的插件。通过该插件，您可以根据正则表达式匹配的结果来输出捕获组，并且可以将这些捕获组作为纯文本或计算表达式的值。

使用方法

首先，您需要导入 regex_transformer 包：

import 'package:regex_transformer/regex_transformer.dart';

RegexTransformer 类有两个主要的方法：transform 和 transformAll。

• transform 方法会匹配输入文本中的第一个符合正则表达式的子串，并返回输出模板中对应的捕获组。
• transformAll 方法会匹配输入文本中的所有符合正则表达式的子串，并将每个匹配结果替换为解析后的输出。

捕获组

索引捕获组

/// 这个转换器定义了三个索引捕获组，并根据输出模板返回它们。
final transformer = RegexTransformer(
  regex: RegExp(r'(.*) .* (.*) .* (.*)'),
  output: r'$1 + $2 = $3',
);

// 输出: one + two = fish
print(transformer.transform('one plus two equals fish'));

注意：$0 可以用来输出整个匹配项。

/// 这个转换器会在整个匹配项周围添加括号。
final transformer = RegexTransformer(
  regex: RegExp(r'[a-z]+'),
  output: r'($0)',
);

// 输出: (one) (plus) (two) (equals) (fish)
print(transformer.transformAll('one plus two equals fish'));

命名捕获组

/// 这个转换器定义了三个命名捕获组，并根据输出模板返回它们。
final transformer = RegexTransformer(
  regex: RegExp(r'(?<one>.*) .* (?<two>.*) .* (?<three>.*)'),
  output: r'$one + $two = $three',
);

// 输出: one + two = fish
print(transformer.transform('one plus two equals fish'));

注意：命名捕获组也会分配一个索引，所以在使用命名和索引捕获组注解时，需要考虑索引计数。

转义

/// 这个转换器使用转义字符来打破捕获组的ID，使得它们可以直接与其它字母数字字符相邻输出。
final transformer = RegexTransformer(
  regex: RegExp(r'(?<one>.*) .* (?<two>.*) .* (?<three>.*)'),
  output: r'$one\plus$two\equals\$three',
);

// 输出: oneplustwoequals$three
print(transformer.transform('one plus two equals fish'));

表达式

/// 这个转换器评估一个表达式并输出结果。
final transformer = RegexTransformer(
  regex: RegExp(r'(?<one>[0-9]).*(?<two>[0-9])'),
  output: r'$one + $two = $($one + $two)',
);

// 输出: 2 + 3 = 5
print(transformer.transform('2 + 3 = fish'));

变量与函数

/// 这个转换器定义的输出模板中的表达式可以利用提供的 `ceil` 和 `combine` 函数。
final transformer = RegexTransformer(
  regex: RegExp(r'([0-9]) \+ ([0-9]) = ([a-z]*)'),
  variables: {
    'ceil': (double input) => input.ceil(),
    'combine': (String input) => input.codeUnits.reduce((a, b) => a + b),
    'oneHundred': 100,
  },
  output: r'$1 + $2 = $(ceil(combine($3) / oneHundred))',
);

// 输出: 2 + 3 = 5
print(transformer.transform('2 + 3 = fish'));

数学运算

/// 这个转换器定义的输出模板中的表达式可以利用 `dart:math` 库中的常量和函数。
final transformer = RegexTransformer(
  regex: RegExp(r'([0-9]) \+ ([0-9]) = ([a-z]*)'),
  output: r'$3 = $(round((sin(($2 * pi) * ($2 / $1)) + cos(($1 * pi) * ($1 / $2))) * 10))',
  math: true,
);

// 输出: fish = 5
print(transformer.transform('2 + 3 = fish'));

严格转换器

设置 RegexTransformer 的 strict 参数为 true，如果解析输出模板或输入文本时发生错误，将会抛出异常。

/// 这个转换器会因为正则表达式的捕获组未命名而抛出 [ArgumentError]。
final transformer = RegexTransformer(
  regex: RegExp(r'(.*) .* (.*) .* (.*)'),
  output: r'$one + $two = $three',
  strict: true,
);

扩展方法

该包还扩展了 String 和 RegExp 类，增加了 transform 和 transformAll 方法。

final myString = 'one plus two equals fish';

// 输出: one + two = fish
print(myString.transform(RegExp(r'(.*) .* (.*) .* (.*)'), r'$1 + $2 = $3'));

// 输出: (one) (plus) (two) (equals) (fish)
print(myString.transformAll(RegExp(r'[a-z]+'), r'($0)'));

final myRegex = RegExp(r'(.*) .* (.*) .* (.*)');

// 输出: one + two = fish
print(myRegex.transform('one plus two equals fish', r'$1 + $2 = $3'));

final myRegex = RegExp(r'[a-z]+');

// 输出: (one) (plus) (two) (equals) (fish)
print(myRegex.transformAll('one plus two equals fish', r'($0)'));