org.dromara.hutool.core.text.split

Class SplitUtil

java.lang.Object

org.dromara.hutool.core.text.split.SplitUtil

public class SplitUtil
extends Object

字符串切分器，封装统一的字符串分割静态方法

Since:

5.7.0

Author:

Looly

Field Summary

Fields

Modifier and Type	Field and Description
static int	UNLIMITED 无限制切分个数

Constructor Summary

Constructors

Constructor and Description
SplitUtil()

Method Summary

Modifier and Type	Method and Description
static List<String>	split(CharSequence str, CharSequence separator) 切分字符串，如果分隔符不存在则返回原字符串 此方法不会去除切分字符串后每个元素两边的空格，不忽略空串
static List<String>	split(CharSequence str, CharSequence separator, boolean isTrim, boolean ignoreEmpty) 切分字符串，不忽略大小写 os
static List<String>	split(CharSequence str, CharSequence separator, int limit, boolean isTrim, boolean ignoreEmpty) 切分字符串，不忽略大小写
static List<String>	split(CharSequence str, CharSequence separator, int limit, boolean isTrim, boolean ignoreEmpty, boolean ignoreCase) 切分字符串 如果提供的字符串为null，则返回一个空的ArrayList 如果提供的字符串为""，则当ignoreEmpty时返回空的ArrayList，否则返回只有一个""元素的ArrayList
static <R> List<R>	split(CharSequence str, CharSequence separator, int limit, boolean ignoreEmpty, boolean ignoreCase, Function<String,R> mapping) 切分字符串 如果提供的字符串为null，则返回一个空的ArrayList 如果提供的字符串为""，则当ignoreEmpty时返回空的ArrayList，否则返回只有一个""元素的ArrayList
static List<String>	splitByBlank(CharSequence str) 使用空白符切分字符串 切分后的字符串两边不包含空白符，空串或空白符串并不做为元素之一 如果为空字符串或者null 则返回空集合
static List<String>	splitByBlank(CharSequence str, int limit) 使用空白符切分字符串 切分后的字符串两边不包含空白符，空串或空白符串并不做为元素之一 如果为空字符串或者null 则返回空集合
static String[]	splitByBlankToArray(CharSequence str, int limit) 切分字符串为字符串数组
static String[]	splitByLength(CharSequence str, int len) 根据给定长度，将给定字符串截取为多个部分
static List<String>	splitByRegex(CharSequence str, Pattern separatorPattern, int limit, boolean isTrim, boolean ignoreEmpty) 通过正则切分字符串，规则如下： 当提供的str为null时，返回new ArrayList(0) 当提供的str为""时，返回[""] 当提供的separatorRegex为empty(null or "")时，返回[str]，即只有原串一个元素的数组
static List<String>	splitByRegex(CharSequence str, String separatorRegex, int limit, boolean isTrim, boolean ignoreEmpty) 通过正则切分字符串，规则如下： 当提供的str为null时，返回new ArrayList(0) 当提供的str为""时，返回[""] 当提供的separatorRegex为empty(null or "")时，返回[str]，即只有原串一个元素的数组
static String[]	splitByRegexToArray(CharSequence str, Pattern separatorPattern, int limit, boolean isTrim, boolean ignoreEmpty) 通过正则切分字符串为字符串数组
static List<String>	splitPath(CharSequence str) 切分路径字符串 如果为空字符串或者null 则返回空集合 空路径会被忽略
static List<String>	splitPath(CharSequence str, int limit) 切分路径字符串 如果为空字符串或者null 则返回空集合 空路径会被忽略
static <T> T	splitTo(CharSequence str, CharSequence separator, Class<T> resultType) 切分字符串，去除切分后每个元素两边的空白符，去除空白项，并转为结果类型
static String[]	splitToArray(CharSequence str, CharSequence separator) 切分字符串，如果分隔符不存在则返回原字符串 此方法不会去除切分字符串后每个元素两边的空格，不忽略空串
static List<String>	splitTrim(CharSequence str, CharSequence separator) 切分字符串，去除切分后每个元素两边的空白符，去除空白项
static Function<String,String>	trimFunc(boolean isTrim) Trim函数

Methods inherited from class java.lang.Object

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

Field Detail

UNLIMITED

public static final int UNLIMITED

无限制切分个数

See Also:

Constant Field Values

Constructor Detail

SplitUtil

public SplitUtil()

Method Detail

splitTo

public static <T> T splitTo(CharSequence str,
                            CharSequence separator,
                            Class<T> resultType)

切分字符串，去除切分后每个元素两边的空白符，去除空白项，并转为结果类型

Type Parameters:

T - 结果类型

Parameters:

str - 被切分的字符串

separator - 分隔符字符

resultType - 结果类型的类，可以是数组或集合

Returns:

long数组

splitTrim

public static List<String> splitTrim(CharSequence str,
                                     CharSequence separator)

切分字符串，去除切分后每个元素两边的空白符，去除空白项

Parameters:

str - 被切分的字符串

separator - 分隔符字符

Returns:

切分后的集合

Since:

3.2.0

splitToArray

public static String[] splitToArray(CharSequence str,
                                    CharSequence separator)

切分字符串，如果分隔符不存在则返回原字符串
此方法不会去除切分字符串后每个元素两边的空格，不忽略空串

Parameters:

str - 被切分的字符串

separator - 分隔符

Returns:

字符串

split

public static List<String> split(CharSequence str,
                                 CharSequence separator)

切分字符串，如果分隔符不存在则返回原字符串
此方法不会去除切分字符串后每个元素两边的空格，不忽略空串

Parameters:

str - 被切分的字符串

separator - 分隔符

Returns:

字符串

split

public static List<String> split(CharSequence str,
                                 CharSequence separator,
                                 boolean isTrim,
                                 boolean ignoreEmpty)

切分字符串，不忽略大小写 os

Parameters:

str - 被切分的字符串

separator - 分隔符字符串

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

Returns:

切分后的集合

Since:

3.0.8

split

public static List<String> split(CharSequence str,
                                 CharSequence separator,
                                 int limit,
                                 boolean isTrim,
                                 boolean ignoreEmpty)

切分字符串，不忽略大小写

Parameters:

str - 被切分的字符串

separator - 分隔符字符串

limit - 限制分片数，小于等于0表示无限制

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

Returns:

切分后的集合

Since:

3.0.8

split

public static List<String> split(CharSequence str,
                                 CharSequence separator,
                                 int limit,
                                 boolean isTrim,
                                 boolean ignoreEmpty,
                                 boolean ignoreCase)

切分字符串
如果提供的字符串为null，则返回一个空的ArrayList
如果提供的字符串为""，则当ignoreEmpty时返回空的ArrayList，否则返回只有一个""元素的ArrayList

Parameters:

str - 被切分的字符串

separator - 分隔符字符串

limit - 限制分片数，小于等于0表示无限制

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

ignoreCase - 是否忽略大小写

Returns:

切分后的集合

split

public static <R> List<R> split(CharSequence str,
                                CharSequence separator,
                                int limit,
                                boolean ignoreEmpty,
                                boolean ignoreCase,
                                Function<String,R> mapping)

切分字符串
如果提供的字符串为null，则返回一个空的ArrayList
如果提供的字符串为""，则当ignoreEmpty时返回空的ArrayList，否则返回只有一个""元素的ArrayList

Type Parameters:

R - 元素类型

Parameters:

str - 被切分的字符串

separator - 分隔符字符串

limit - 限制分片数，小于等于0表示无限制

ignoreEmpty - 是否忽略空串

ignoreCase - 是否忽略大小写

mapping - 切分后字段映射函数

Returns:

切分后的集合

splitPath

public static List<String> splitPath(CharSequence str)

切分路径字符串
如果为空字符串或者null 则返回空集合

空路径会被忽略

Parameters:

str - 被切分的字符串

Returns:

切分后的集合

splitPath

public static List<String> splitPath(CharSequence str,
                                     int limit)

切分路径字符串
如果为空字符串或者null 则返回空集合
空路径会被忽略

Parameters:

str - 被切分的字符串

limit - 限制分片数，小于等于0表示无限制

Returns:

切分后的集合

Since:

3.0.8

splitByBlank

public static List<String> splitByBlank(CharSequence str)

使用空白符切分字符串
切分后的字符串两边不包含空白符，空串或空白符串并不做为元素之一
如果为空字符串或者null 则返回空集合

Parameters:

str - 被切分的字符串

Returns:

切分后的集合

splitByBlank

public static List<String> splitByBlank(CharSequence str,
                                        int limit)

使用空白符切分字符串
切分后的字符串两边不包含空白符，空串或空白符串并不做为元素之一
如果为空字符串或者null 则返回空集合

Parameters:

str - 被切分的字符串

limit - 限制分片数，小于等于0表示无限制

Returns:

切分后的集合

Since:

3.0.8

splitByBlankToArray

public static String[] splitByBlankToArray(CharSequence str,
                                           int limit)

切分字符串为字符串数组

Parameters:

str - 被切分的字符串

limit - 限制分片数，小于等于0表示无限制

Returns:

切分后的集合

Since:

3.0.8

splitByRegex

public static List<String> splitByRegex(CharSequence str,
                                        String separatorRegex,
                                        int limit,
                                        boolean isTrim,
                                        boolean ignoreEmpty)

通过正则切分字符串，规则如下：

• 当提供的str为null时，返回new ArrayList(0)
• 当提供的str为""时，返回[""]
• 当提供的separatorRegex为empty(null or "")时，返回[str]，即只有原串一个元素的数组

Parameters:

str - 字符串

separatorRegex - 分隔符正则

limit - 限制分片数，小于等于0表示无限制

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

Returns:

切分后的集合

Since:

3.0.8

splitByRegex

public static List<String> splitByRegex(CharSequence str,
                                        Pattern separatorPattern,
                                        int limit,
                                        boolean isTrim,
                                        boolean ignoreEmpty)

通过正则切分字符串，规则如下：

• 当提供的str为null时，返回new ArrayList(0)
• 当提供的str为""时，返回[""]
• 当提供的separatorRegex为empty(null or "")时，返回[str]，即只有原串一个元素的数组

Parameters:

str - 字符串

separatorPattern - 分隔符正则Pattern

limit - 限制分片数，小于等于0表示无限制

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

Returns:

切分后的集合

Since:

3.0.8

splitByRegexToArray

public static String[] splitByRegexToArray(CharSequence str,
                                           Pattern separatorPattern,
                                           int limit,
                                           boolean isTrim,
                                           boolean ignoreEmpty)

通过正则切分字符串为字符串数组

Parameters:

str - 被切分的字符串

separatorPattern - 分隔符正则Pattern

limit - 限制分片数，小于等于0表示无限制

isTrim - 是否去除切分字符串后每个元素两边的空格

ignoreEmpty - 是否忽略空串

Returns:

切分后的集合

Since:

3.0.8

splitByLength

public static String[] splitByLength(CharSequence str,
                                     int len)

根据给定长度，将给定字符串截取为多个部分

Parameters:

str - 字符串

len - 每一个小节的长度，必须大于0

Returns:

截取后的字符串数组

trimFunc

public static Function<String,String> trimFunc(boolean isTrim)

Trim函数

Parameters:

isTrim - 是否trim

Returns:

Function