cn.hutool.core.util

类 ReUtil

java.lang.Object

cn.hutool.core.util.ReUtil

public class ReUtil
extends java.lang.Object

正则相关工具类
常用正则请见 Validator

作者:

xiaoleilu

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	RE_CHINESE 正则表达式匹配中文汉字
static java.lang.String	RE_CHINESES 正则表达式匹配中文字符串
static java.util.Set<java.lang.Character>	RE_KEYS 正则中需要被转义的关键字

构造器概要

构造器

构造器和说明
ReUtil()

方法概要

方法

限定符和类型	方法和说明
static boolean	contains(java.util.regex.Pattern pattern, java.lang.String content) 指定内容中是否有表达式匹配的内容
static boolean	contains(java.lang.String regex, java.lang.String content) 指定内容中是否有表达式匹配的内容
static int	count(java.util.regex.Pattern pattern, java.lang.String content) 计算指定字符串中，匹配pattern的个数
static int	count(java.lang.String regex, java.lang.String content) 计算指定字符串中，匹配pattern的个数
static java.lang.String	delAll(java.util.regex.Pattern pattern, java.lang.String content) 删除匹配的全部内容
static java.lang.String	delAll(java.lang.String regex, java.lang.String content) 删除匹配的全部内容
static java.lang.String	delFirst(java.util.regex.Pattern pattern, java.lang.String content) 删除匹配的第一个内容
static java.lang.String	delFirst(java.lang.String regex, java.lang.String content) 删除匹配的第一个内容
static java.lang.String	delPre(java.lang.String regex, java.lang.String content) 删除正则匹配到的内容之前的字符 如果没有找到，则返回原文
static java.lang.String	escape(char c) 转义字符，将正则的关键字转义
static java.lang.String	escape(java.lang.String content) 转义字符串，将正则的关键字转义
static java.lang.String	extractMulti(java.util.regex.Pattern pattern, java.lang.String content, java.lang.String template) 从content中匹配出多个值并根据template生成新的字符串 例如： content 2013年5月 pattern (.*?)
static java.lang.String	extractMulti(java.lang.String regex, java.lang.String content, java.lang.String template) 从content中匹配出多个值并根据template生成新的字符串 匹配结束后会删除匹配内容之前的内容（包括匹配内容） 例如： content 2013年5月 pattern (.*?)
static java.lang.String	extractMultiAndDelPre(java.util.regex.Pattern pattern, Holder<java.lang.String> contentHolder, java.lang.String template) 从content中匹配出多个值并根据template生成新的字符串 匹配结束后会删除匹配内容之前的内容（包括匹配内容） 例如： content 2013年5月 pattern (.*?)
static java.lang.String	extractMultiAndDelPre(java.lang.String regex, Holder<java.lang.String> contentHolder, java.lang.String template) 从content中匹配出多个值并根据template生成新的字符串 例如： content 2013年5月 pattern (.*?)
static java.util.List<java.lang.String>	findAll(java.util.regex.Pattern pattern, java.lang.String content, int group) 取得内容中匹配的所有结果
static <T extends java.util.Collection<java.lang.String>> T	findAll(java.util.regex.Pattern pattern, java.lang.String content, int group, T collection) 取得内容中匹配的所有结果
static java.util.List<java.lang.String>	findAll(java.lang.String regex, java.lang.String content, int group) 取得内容中匹配的所有结果
static <T extends java.util.Collection<java.lang.String>> T	findAll(java.lang.String regex, java.lang.String content, int group, T collection) 取得内容中匹配的所有结果
static java.util.List<java.lang.String>	findAllGroup0(java.util.regex.Pattern pattern, java.lang.String content) 取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组0的内容
static java.util.List<java.lang.String>	findAllGroup0(java.lang.String regex, java.lang.String content) 取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组0的内容
static java.util.List<java.lang.String>	findAllGroup1(java.util.regex.Pattern pattern, java.lang.String content) 取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组1的内容
static java.util.List<java.lang.String>	findAllGroup1(java.lang.String regex, java.lang.String content) 取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组1的内容
static java.lang.String	get(java.util.regex.Pattern pattern, java.lang.String content, int groupIndex) 获得匹配的字符串，对应分组0表示整个匹配内容，1表示第一个括号分组内容，依次类推
static java.lang.String	get(java.lang.String regex, java.lang.String content, int groupIndex) 获得匹配的字符串
static java.util.List<java.lang.String>	getAllGroups(java.util.regex.Pattern pattern, java.lang.String content) 获得匹配的字符串匹配到的所有分组
static java.util.List<java.lang.String>	getAllGroups(java.util.regex.Pattern pattern, java.lang.String content, boolean withGroup0) 获得匹配的字符串匹配到的所有分组
static java.lang.Integer	getFirstNumber(java.lang.String StringWithNumber) 从字符串中获得第一个整数
static java.lang.String	getGroup0(java.util.regex.Pattern pattern, java.lang.String content) 获得匹配的字符串，，获得正则中分组0的内容
static java.lang.String	getGroup0(java.lang.String regex, java.lang.String content) 获得匹配的字符串，获得正则中分组0的内容
static java.lang.String	getGroup1(java.util.regex.Pattern pattern, java.lang.String content) 获得匹配的字符串，，获得正则中分组1的内容
static java.lang.String	getGroup1(java.lang.String regex, java.lang.String content) 获得匹配的字符串，获得正则中分组1的内容
static boolean	isMatch(java.util.regex.Pattern pattern, java.lang.String content) 给定内容是否匹配正则
static boolean	isMatch(java.lang.String regex, java.lang.String content) 给定内容是否匹配正则
static java.lang.String	replaceAll(java.lang.String content, java.util.regex.Pattern pattern, java.lang.String replacementTemplate) 正则替换指定值 通过正则查找到字符串，然后把匹配到的字符串加入到replacementTemplate中，$1表示分组1的字符串
static java.lang.String	replaceAll(java.lang.String content, java.lang.String regex, java.lang.String replacementTemplate) 正则替换指定值 通过正则查找到字符串，然后把匹配到的字符串加入到replacementTemplate中，$1表示分组1的字符串

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

RE_CHINESE

public static final java.lang.String RE_CHINESE

正则表达式匹配中文汉字

另请参阅:

常量字段值

RE_CHINESES

public static final java.lang.String RE_CHINESES

正则表达式匹配中文字符串

另请参阅:

常量字段值

RE_KEYS

public static final java.util.Set<java.lang.Character> RE_KEYS

正则中需要被转义的关键字

构造器详细资料

ReUtil

public ReUtil()

方法详细资料

getGroup0

public static java.lang.String getGroup0(java.lang.String regex,
                         java.lang.String content)

获得匹配的字符串，获得正则中分组0的内容

参数:

regex - 匹配的正则

content - 被匹配的内容

返回:

匹配后得到的字符串，未匹配返回null

从以下版本开始:

3.1.2

getGroup1

public static java.lang.String getGroup1(java.lang.String regex,
                         java.lang.String content)

获得匹配的字符串，获得正则中分组1的内容

参数:

regex - 匹配的正则

content - 被匹配的内容

返回:

匹配后得到的字符串，未匹配返回null

从以下版本开始:

3.1.2

get

public static java.lang.String get(java.lang.String regex,
                   java.lang.String content,
                   int groupIndex)

获得匹配的字符串

参数:

regex - 匹配的正则

content - 被匹配的内容

groupIndex - 匹配正则的分组序号

返回:

匹配后得到的字符串，未匹配返回null

getGroup0

public static java.lang.String getGroup0(java.util.regex.Pattern pattern,
                         java.lang.String content)

获得匹配的字符串，，获得正则中分组0的内容

参数:

pattern - 编译后的正则模式

content - 被匹配的内容

返回:

匹配后得到的字符串，未匹配返回null

从以下版本开始:

3.1.2

getGroup1

public static java.lang.String getGroup1(java.util.regex.Pattern pattern,
                         java.lang.String content)

获得匹配的字符串，，获得正则中分组1的内容

参数:

pattern - 编译后的正则模式

content - 被匹配的内容

返回:

匹配后得到的字符串，未匹配返回null

从以下版本开始:

3.1.2

get

public static java.lang.String get(java.util.regex.Pattern pattern,
                   java.lang.String content,
                   int groupIndex)

获得匹配的字符串，对应分组0表示整个匹配内容，1表示第一个括号分组内容，依次类推

参数:

pattern - 编译后的正则模式

content - 被匹配的内容

groupIndex - 匹配正则的分组序号，0表示整个匹配内容，1表示第一个括号分组内容，依次类推

返回:

匹配后得到的字符串，未匹配返回null

getAllGroups

public static java.util.List<java.lang.String> getAllGroups(java.util.regex.Pattern pattern,
                                            java.lang.String content)

获得匹配的字符串匹配到的所有分组

参数:

pattern - 编译后的正则模式

content - 被匹配的内容

返回:

匹配后得到的字符串数组，按照分组顺序依次列出，未匹配到返回空列表，任何一个参数为null返回null

从以下版本开始:

3.1.0

getAllGroups

public static java.util.List<java.lang.String> getAllGroups(java.util.regex.Pattern pattern,
                                            java.lang.String content,
                                            boolean withGroup0)

获得匹配的字符串匹配到的所有分组

参数:

pattern - 编译后的正则模式

content - 被匹配的内容

withGroup0 - 是否包括分组0，此分组表示全匹配的信息

返回:

匹配后得到的字符串数组，按照分组顺序依次列出，未匹配到返回空列表，任何一个参数为null返回null

从以下版本开始:

4.0.13

extractMulti

public static java.lang.String extractMulti(java.util.regex.Pattern pattern,
                            java.lang.String content,
                            java.lang.String template)

从content中匹配出多个值并根据template生成新的字符串
例如：
content 2013年5月 pattern (.*?)年(.*?)月 template： $1-$2 return 2013-5

参数:

pattern - 匹配正则

content - 被匹配的内容

template - 生成内容模板，变量 $1 表示group1的内容，以此类推

返回:

新字符串

extractMulti

public static java.lang.String extractMulti(java.lang.String regex,
                            java.lang.String content,
                            java.lang.String template)

从content中匹配出多个值并根据template生成新的字符串
匹配结束后会删除匹配内容之前的内容（包括匹配内容）
例如：
content 2013年5月 pattern (.*?)年(.*?)月 template： $1-$2 return 2013-5

参数:

regex - 匹配正则字符串

content - 被匹配的内容

template - 生成内容模板，变量 $1 表示group1的内容，以此类推

返回:

按照template拼接后的字符串

extractMultiAndDelPre

public static java.lang.String extractMultiAndDelPre(java.util.regex.Pattern pattern,
                                     Holder<java.lang.String> contentHolder,
                                     java.lang.String template)

从content中匹配出多个值并根据template生成新的字符串
匹配结束后会删除匹配内容之前的内容（包括匹配内容）
例如：
content 2013年5月 pattern (.*?)年(.*?)月 template： $1-$2 return 2013-5

参数:

pattern - 匹配正则

contentHolder - 被匹配的内容的Holder，value为内容正文，经过这个方法的原文将被去掉匹配之前的内容

template - 生成内容模板，变量 $1 表示group1的内容，以此类推

返回:

新字符串

extractMultiAndDelPre

public static java.lang.String extractMultiAndDelPre(java.lang.String regex,
                                     Holder<java.lang.String> contentHolder,
                                     java.lang.String template)

从content中匹配出多个值并根据template生成新的字符串
例如：
content 2013年5月 pattern (.*?)年(.*?)月 template： $1-$2 return 2013-5

参数:

regex - 匹配正则字符串

contentHolder - 被匹配的内容的Holder，value为内容正文，经过这个方法的原文将被去掉匹配之前的内容

template - 生成内容模板，变量 $1 表示group1的内容，以此类推

返回:

按照template拼接后的字符串

delFirst

public static java.lang.String delFirst(java.lang.String regex,
                        java.lang.String content)

删除匹配的第一个内容

参数:

regex - 正则

content - 被匹配的内容

返回:

删除后剩余的内容

delFirst

public static java.lang.String delFirst(java.util.regex.Pattern pattern,
                        java.lang.String content)

删除匹配的第一个内容

参数:

pattern - 正则

content - 被匹配的内容

返回:

删除后剩余的内容

delAll

public static java.lang.String delAll(java.lang.String regex,
                      java.lang.String content)

删除匹配的全部内容

参数:

regex - 正则

content - 被匹配的内容

返回:

删除后剩余的内容

delAll

public static java.lang.String delAll(java.util.regex.Pattern pattern,
                      java.lang.String content)

删除匹配的全部内容

参数:

pattern - 正则

content - 被匹配的内容

返回:

删除后剩余的内容

delPre

public static java.lang.String delPre(java.lang.String regex,
                      java.lang.String content)

删除正则匹配到的内容之前的字符 如果没有找到，则返回原文

参数:

regex - 定位正则

content - 被查找的内容

返回:

删除前缀后的新内容

findAllGroup0

public static java.util.List<java.lang.String> findAllGroup0(java.lang.String regex,
                                             java.lang.String content)

取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组0的内容

参数:

regex - 正则

content - 被查找的内容

返回:

结果列表

从以下版本开始:

3.1.2

findAllGroup1

public static java.util.List<java.lang.String> findAllGroup1(java.lang.String regex,
                                             java.lang.String content)

取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组1的内容

参数:

regex - 正则

content - 被查找的内容

返回:

结果列表

从以下版本开始:

3.1.2

findAll

public static java.util.List<java.lang.String> findAll(java.lang.String regex,
                                       java.lang.String content,
                                       int group)

取得内容中匹配的所有结果

参数:

regex - 正则

content - 被查找的内容

group - 正则的分组

返回:

结果列表

从以下版本开始:

3.0.6

findAll

public static <T extends java.util.Collection<java.lang.String>> T findAll(java.lang.String regex,
                                                           java.lang.String content,
                                                           int group,
                                                           T collection)

取得内容中匹配的所有结果

类型参数:

T - 集合类型

参数:

regex - 正则

content - 被查找的内容

group - 正则的分组

collection - 返回的集合类型

返回:

结果集

findAllGroup0

public static java.util.List<java.lang.String> findAllGroup0(java.util.regex.Pattern pattern,
                                             java.lang.String content)

取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组0的内容

参数:

pattern - 编译后的正则模式

content - 被查找的内容

返回:

结果列表

从以下版本开始:

3.1.2

findAllGroup1

public static java.util.List<java.lang.String> findAllGroup1(java.util.regex.Pattern pattern,
                                             java.lang.String content)

取得内容中匹配的所有结果，获得匹配的所有结果中正则对应分组1的内容

参数:

pattern - 编译后的正则模式

content - 被查找的内容

返回:

结果列表

从以下版本开始:

3.1.2

findAll

public static java.util.List<java.lang.String> findAll(java.util.regex.Pattern pattern,
                                       java.lang.String content,
                                       int group)

取得内容中匹配的所有结果

参数:

pattern - 编译后的正则模式

content - 被查找的内容

group - 正则的分组

返回:

结果列表

从以下版本开始:

3.0.6

findAll

public static <T extends java.util.Collection<java.lang.String>> T findAll(java.util.regex.Pattern pattern,
                                                           java.lang.String content,
                                                           int group,
                                                           T collection)

取得内容中匹配的所有结果

类型参数:

T - 集合类型

参数:

pattern - 编译后的正则模式

content - 被查找的内容

group - 正则的分组

collection - 返回的集合类型

返回:

结果集

count

public static int count(java.lang.String regex,
        java.lang.String content)

计算指定字符串中，匹配pattern的个数

参数:

regex - 正则表达式

content - 被查找的内容

返回:

匹配个数

count

public static int count(java.util.regex.Pattern pattern,
        java.lang.String content)

计算指定字符串中，匹配pattern的个数

参数:

pattern - 编译后的正则模式

content - 被查找的内容

返回:

匹配个数

contains

public static boolean contains(java.lang.String regex,
               java.lang.String content)

指定内容中是否有表达式匹配的内容

参数:

regex - 正则表达式

content - 被查找的内容

返回:

指定内容中是否有表达式匹配的内容

从以下版本开始:

3.3.1

contains

public static boolean contains(java.util.regex.Pattern pattern,
               java.lang.String content)

指定内容中是否有表达式匹配的内容

参数:

pattern - 编译后的正则模式

content - 被查找的内容

返回:

指定内容中是否有表达式匹配的内容

从以下版本开始:

3.3.1

getFirstNumber

public static java.lang.Integer getFirstNumber(java.lang.String StringWithNumber)

从字符串中获得第一个整数

参数:

StringWithNumber - 带数字的字符串

返回:

整数

isMatch

public static boolean isMatch(java.lang.String regex,
              java.lang.String content)

给定内容是否匹配正则

参数:

regex - 正则

content - 内容

返回:

正则为null或者""则不检查，返回true，内容为null返回false

isMatch

public static boolean isMatch(java.util.regex.Pattern pattern,
              java.lang.String content)

给定内容是否匹配正则

参数:

pattern - 模式

content - 内容

返回:

正则为null或者""则不检查，返回true，内容为null返回false

replaceAll

public static java.lang.String replaceAll(java.lang.String content,
                          java.lang.String regex,
                          java.lang.String replacementTemplate)

正则替换指定值
通过正则查找到字符串，然后把匹配到的字符串加入到replacementTemplate中，$1表示分组1的字符串

参数:

content - 文本

regex - 正则

replacementTemplate - 替换的文本模板，可以使用$1类似的变量提取正则匹配出的内容

返回:

处理后的文本

replaceAll

public static java.lang.String replaceAll(java.lang.String content,
                          java.util.regex.Pattern pattern,
                          java.lang.String replacementTemplate)

正则替换指定值
通过正则查找到字符串，然后把匹配到的字符串加入到replacementTemplate中，$1表示分组1的字符串

参数:

content - 文本

pattern - Pattern

replacementTemplate - 替换的文本模板，可以使用$1类似的变量提取正则匹配出的内容

返回:

处理后的文本

从以下版本开始:

3.0.4

escape

public static java.lang.String escape(char c)

转义字符，将正则的关键字转义

参数:

c - 字符

返回:

转义后的文本

escape

public static java.lang.String escape(java.lang.String content)

转义字符串，将正则的关键字转义

参数:

content - 文本

返回:

转义后的文本