1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
use regex::Regex;
/// 正则工具，如匹配、捕获第一个、捕获所有等
pub struct ReUtil;
impl ReUtil {
/// 检查文本是否匹配给定的正则表达式模式
///
/// # 参数
/// * `re` - 正则表达式模式字符串
/// * `text` - 要检查的文本字符串
///
/// # 返回值
/// 如果文本匹配正则表达式模式则返回true，否则返回false
///
/// # Panics
/// 当正则表达式模式无效时会panic
pub fn is_match(re: &str, text: &str) -> bool {
// 编译正则表达式模式
let re = Regex::new(re).unwrap();
// 执行匹配检查
re.is_match(text)
}
/// 在给定文本中查找第一个匹配正则表达式的子串
///
/// # 参数
/// * `re` - 要匹配的正则表达式字符串
/// * `text` - 要搜索的文本内容
///
/// # 返回值
/// 返回第一个匹配的子串引用，如果没有匹配则返回None
///
/// # 示例
/// ```
/// let result = find_first(r"\d+", "abc123def456");
/// assert_eq!(result, Some("123"));
/// ```
pub fn find_first<'a>(re: &str, text: &'a str) -> Option<&'a str> {
// 编译正则表达式
let re = Regex::new(re).unwrap();
// 查找第一个匹配项
if let Some(captured) = re.find(text) {
let result = captured.as_str();
return Some(result);
}
None
}
/// 在给定文本中查找所有匹配正则表达式的子串
///
/// # 参数
/// * `re` - 要使用的正则表达式字符串
/// * `text` - 要搜索的文本
///
/// # 返回值
/// 返回包含所有匹配子串的字符串向量
///
/// # 示例
/// ```
/// let matches = find_all(r"\d+", "abc123def456");
/// assert_eq!(matches, vec!["123", "456"]);
/// ```
pub fn find_all(re: &str, text: &str) -> Vec<String> {
// 编译正则表达式，如果编译失败则panic
let re = Regex::new(re).unwrap();
let mut vec = Vec::new();
// 遍历所有匹配项，提取完整匹配并添加到结果向量中
for cap in re.captures_iter(text) {
let s = cap[0].to_string();
vec.push(s);
}
vec
}
/// 使用正则表达式匹配文本并返回所有捕获组的字符串列表
///
/// # 参数
/// * `re` - 正则表达式字符串
/// * `text` - 要匹配的文本字符串
///
/// # 返回值
/// 返回包含所有捕获组匹配结果的字符串向量，如果没有匹配则返回空向量
///
/// # 示例
/// ```
/// let result = captures(r"^images_(\d{4}-\d{2}-\d{2})_([a-zA-Z0-9]+).jpg$", "images_2025-01-01_xxxx.jpg");
/// assert_eq!(result, vec!["images_2025-01-01_xxxx.jpg", "2025-01-01", "xxxx"]);
/// ```
pub fn captures(re: &str, text: &str) -> Vec<String> {
let re = Regex::new(re).unwrap();
let mut vec = Vec::new();
let caps = re.captures(text);
// 遍历所有捕获组并将其转换为字符串添加到结果向量中
if let Some(caps) = caps {
for cap in caps.iter() {
if let Some(cap) = cap {
let s = cap.as_str().to_string();
vec.push(s);
}
}
}
vec
}
}
#[cfg(test)]
mod tests {
#[test]
fn test_re_util() {
let re = r"^images_(\d{4}-\d{2}-\d{2})_([a-zA-Z0-9]+).jpg$";
let text = "images_2025-01-01_xxxx.jpg";
let vec = super::ReUtil::captures(re, text);
println!("{:?}", vec);
}
}