# 正则提取

使用正则表达式从文本中提取方式。<br />本模块需要您了解正则表达式相关知识之后才可以使用。<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/272392/1581926462615-c727b840-921f-4e7d-882a-2542075f9d18.png#averageHue=%23fbfafa&height=609&id=aqahF&originHeight=1218&originWidth=1196&originalType=binary&ratio=1&rotation=0&showTitle=false&size=128216&status=done&style=none&title=&width=598)


<a name="dz4nd"></a>
# 参数

<a name="VFNS4"></a>
## 输入
【提取方式】要提取的内容类型。<br />【输入】要从中提取内容的原始文本。<br />【正则表达式】要匹配的正则表达式。<br />【忽略大小写】正则选项，不区分英文大小写。<br />【单行模式】此模式下“.”能匹配任意字符，包括换行符。否则匹配除了\n外的任意字符。单行模式和多行模式相互兼容，可以选择一个、同时选择两个或都不选择。<br />【多行模式】此模式下^和$可以分别匹配行首和行尾。否则匹配输入内容的开始和结束。<br />【失败后中止动作】如果匹配失败则停止后续步骤的执行。

<a name="TuxwY"></a>
## 输出
据提取方式的不同，输出的内容也不太相同。<br />**【所有匹配列表】**

- 提取方式为“各匹配项的值”和“各匹配项的组”时，返回所有匹配项的值的列表。
- 提取方式为“第一个匹配项的组”时，返回该匹配项所有组（Group）的值的列表。

**【匹配1】-【匹配5】**

- 提取方式为“各匹配项的值”时，返回前5个匹配项的值。
- 提取方式为“第一个匹配项的组”时，返回第一个匹配项前5个匹配组（Group）的值。
- 提取方式为“所有匹配项的组”时，返回的是所有匹配项的**对应位置**匹配组的值的**列表**。

**【Matches集合】**提取方式为“各匹配项的值”和“各匹配项的组”时，返回表示所有匹配项的 [**MatchCollection**](https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.matchcollection)** **对象。可以在表达式中使用此对象。<br />**【Match对象】**提取方式为“第一个匹配项的组”时，返回该匹配项的 [**Match**](https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.match)** **对象。可以在表达式中使用此对象。

<a name="iKLur"></a>
## 示例
假设**输入**内容为：
```
a1 b2 c3 d4
e5 f6 g7 h8
```

正则表达式为：
```
([a-z])([0-9])
```

在各提取方式类型下，输出的值为：

| **提取方式** | **输出：所有匹配列表** | **匹配1-5** |
| --- | --- | --- |
| 各匹配项的值 | 所有匹配项的值列表。<br />_a1_<br />_b2_<br />_c3_<br />_d4_<br />_e5_<br />_f6_<br />_g7_<br />_h8_ | 前5个匹配项：<br />_匹配1:a1_<br />_匹配2:b2_<br />_匹配3:c3_<br />_匹配4:d4_<br />_匹配5:e5_ |
| 第一个匹配项的组 | 第一个匹配项的所有组的值列表。<br />_a_<br />_1_ | 第一个匹配项前5个Group的值：<br />_匹配1:a_<br />_匹配2:1_<br />_匹配3:_<br />_匹配4:_<br />_匹配5:_ |
| 所有匹配项的组 | 所有匹配项的值列表。<br />_a1_<br />_b2_<br />_c3_<br />_d4_<br />_e5_<br />_f6_<br />_g7_<br />_h8_ | 所有匹配项对应位置匹配组的值列表。<br />_匹配1:a_<br />_b_<br />_c_<br />_d_<br />_e_<br />_匹配2:1_<br />_2_<br />_3_<br />_4_<br />_5_<br />_匹配3:_<br />_匹配4:_<br />_匹配5:_ |


<a name="nvke6"></a>
## 示例动作

- [https://getquicker.net/Sharedaction?code=318b29ef-4bba-4d0c-a918-08d7b30d7779](https://getquicker.net/Sharedaction?code=318b29ef-4bba-4d0c-a918-08d7b30d7779)

<a name="9CYsL"></a>
# 更改历史

- 1.4.20 增加提取方式类型支持。

<a name="XB4zo"></a>
# 参考资料

- [动作] [正则速查手册 ](https://getquicker.net/Sharedaction?code=65a5ee04-29bc-42f0-3962-08db5c50a3af)  作者 @[咿呀杀杀](https://getquicker.net/User/Actions/19337-%E5%92%BF%E5%91%80%E6%9D%80%E6%9D%80)
- 正则表达式教程：[https://deerchao.net/tutorials/regex/regex.htm](https://deerchao.net/tutorials/regex/regex.htm)
- [https://www.runoob.com/csharp/csharp-regular-expressions.html](https://www.runoob.com/csharp/csharp-regular-expressions.html)