模块 elsfs.tool.core

程序包 org.elsfs.tool.core.util

类 CharSequenceUtil

java.lang.Object

org.elsfs.tool.core.util.CharSequenceUtil

public class CharSequenceUtil
extends Object

CharSequence 相关工具类封装

从以下版本开始:

0.0.3

作者:

zeng

字段概要

字段

修饰符和类型	字段	说明
static final String	EMPTY	字符串常量：空字符串 ""

构造器概要

构造器

构造器	说明
CharSequenceUtil()

方法概要

修饰符和类型	方法	说明
static boolean	endWith(CharSequence str, CharSequence suffix)	是否以指定字符串结尾
static boolean	endWith(CharSequence str, CharSequence suffix, boolean ignoreCase)	是否以指定字符串结尾 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false
static boolean	endWith(CharSequence str, CharSequence suffix, boolean ignoreCase, boolean ignoreEquals)	是否以指定字符串结尾 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false
static boolean	endWithIgnoreCase(CharSequence str, CharSequence suffix)	是否以指定字符串结尾，忽略大小写
static boolean	equals(CharSequence str1, CharSequence str2)	比较两个字符串（大小写敏感）。
static boolean	equals(CharSequence str1, CharSequence str2, boolean ignoreCase)	比较两个字符串是否相等，规则如下 str1和str2都为null 忽略大小写使用String.equalsIgnoreCase(String)判断相等 不忽略大小写使用String.contentEquals(CharSequence)判断相等
static boolean	isBlank(CharSequence str)	字符串是否为空白，空白的定义如下： null 空字符串："" 空格、全角空格、制表符、换行符，等不可见字符
static boolean	isEmpty(CharSequence str)	字符串是否为空，空的定义如下： null 空字符串：""
static boolean	startWith(CharSequence str, CharSequence prefix)	是否以指定字符串开头
static boolean	startWith(CharSequence str, CharSequence prefix, boolean ignoreCase)	是否以指定字符串开头 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false
static boolean	startWith(CharSequence str, CharSequence prefix, boolean ignoreCase, boolean ignoreEquals)	是否以指定字符串开头 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false
static boolean	startWithIgnoreCase(CharSequence str, CharSequence prefix)	是否以指定字符串开头，忽略大小写
static String	str(CharSequence cs)	CharSequence 转为字符串，null安全
static String	strip(CharSequence str, CharSequence prefixOrSuffix)	去除两边的指定字符串
static String	strip(CharSequence str, CharSequence prefix, CharSequence suffix)	去除两边的指定字符串
static String	stripIgnoreCase(CharSequence str, CharSequence prefixOrSuffix)	去除两边的指定字符串，忽略大小写
static String	stripIgnoreCase(CharSequence str, CharSequence prefix, CharSequence suffix)	去除两边的指定字符串，忽略大小写
static String	sub(CharSequence str, int fromIndexInclude, int toIndexExclude)	改进JDK subString index从0开始计算，最后一个字符为-1 如果from和to位置一样，返回 "" 如果from或to为负数，则按照length从后向前数位置，如果绝对值大于字符串长度，则from归到0，to归到length 如果经过修正的index中from大于to，则互换from和to example: abcdefgh 2 3 =》 c abcdefgh 2 -3 =》 cde
static String	subSuf(CharSequence string, int fromIndex)	切割指定位置之后部分的字符串
static String	upperFirst(CharSequence str)	大写首字母 例如：str = name, return Name

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

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

字段详细资料

EMPTY

public static final String EMPTY

字符串常量：空字符串 ""

另请参阅:

• 常量字段值

构造器详细资料

CharSequenceUtil

public CharSequenceUtil()

方法详细资料

isBlank

public static boolean isBlank(CharSequence str)

字符串是否为空白，空白的定义如下：

1. null
2. 空字符串：""
3. 空格、全角空格、制表符、换行符，等不可见字符

例：

• StrUtil.isBlank(null) // true
• StrUtil.isBlank("") // true
• StrUtil.isBlank(" \t\n") // true
• StrUtil.isBlank("abc") // false

注意：该方法与 isEmpty(CharSequence) 的区别是： 该方法会校验空白字符，且性能相对于 isEmpty(CharSequence) 略慢。

建议：

• 该方法建议仅对于客户端（或第三方接口）传入的参数使用该方法。

参数:

str - 被检测的字符串

返回:

若为空白，则返回 true

另请参阅:

• isEmpty(CharSequence)

isEmpty

public static boolean isEmpty(CharSequence str)

字符串是否为空，空的定义如下：

1. null
2. 空字符串：""

例：

• StrUtil.isEmpty(null) // true
• StrUtil.isEmpty("") // true
• StrUtil.isEmpty(" \t\n") // false
• StrUtil.isEmpty("abc") // false

注意：该方法与 isBlank(CharSequence) 的区别是：该方法不校验空白字符。

建议：

• 该方法建议用于工具类或任何可以预期的方法参数的校验中。

参数:

str - 被检测的字符串

返回:

是否为空

upperFirst

public static String upperFirst(CharSequence str)

大写首字母
例如：str = name, return Name

参数:

str - 字符串

返回:

字符串

subSuf

public static String subSuf(CharSequence string,
 int fromIndex)

切割指定位置之后部分的字符串

参数:

string - 字符串

fromIndex - 切割开始的位置（包括）

返回:

切割后后剩余的后半部分字符串

sub

public static String sub(CharSequence str,
 int fromIndexInclude,
 int toIndexExclude)

改进JDK subString
index从0开始计算，最后一个字符为-1
如果from和to位置一样，返回 ""
如果from或to为负数，则按照length从后向前数位置，如果绝对值大于字符串长度，则from归到0，to归到length
如果经过修正的index中from大于to，则互换from和to example:
abcdefgh 2 3 =》 c
abcdefgh 2 -3 =》 cde

参数:

str - String

fromIndexInclude - 开始的index（包括）

toIndexExclude - 结束的index（不包括）

返回:

字串

str

public static String str(CharSequence cs)

CharSequence 转为字符串，null安全

参数:

cs - CharSequence

返回:

字符串

equals

public static boolean equals(CharSequence str1,
 CharSequence str2)

比较两个字符串（大小写敏感）。

 equals(null, null)   = true
 equals(null, "abc")  = false
 equals("abc", null)  = false
 equals("abc", "abc") = true
 equals("abc", "ABC") = false
 

参数:

str1 - 要比较的字符串1

str2 - 要比较的字符串2

返回:

如果两个字符串相同，或者都是null，则返回true

equals

public static boolean equals(CharSequence str1,
 CharSequence str2,
 boolean ignoreCase)

比较两个字符串是否相等，规则如下

• str1和str2都为null
• 忽略大小写使用String.equalsIgnoreCase(String)判断相等
• 不忽略大小写使用String.contentEquals(CharSequence)判断相等

参数:

str1 - 要比较的字符串1

str2 - 要比较的字符串2

ignoreCase - 是否忽略大小写

返回:

如果两个字符串相同，或者都是null，则返回true

从以下版本开始:

3.2.0

strip

public static String strip(CharSequence str,
 CharSequence prefixOrSuffix)

去除两边的指定字符串

参数:

str - 被处理的字符串

prefixOrSuffix - 前缀或后缀

返回:

处理后的字符串

从以下版本开始:

3.1.2

strip

public static String strip(CharSequence str,
 CharSequence prefix,
 CharSequence suffix)

去除两边的指定字符串

参数:

str - 被处理的字符串

prefix - 前缀

suffix - 后缀

返回:

处理后的字符串

从以下版本开始:

3.1.2

stripIgnoreCase

public static String stripIgnoreCase(CharSequence str,
 CharSequence prefixOrSuffix)

去除两边的指定字符串，忽略大小写

参数:

str - 被处理的字符串

prefixOrSuffix - 前缀或后缀

返回:

处理后的字符串

从以下版本开始:

3.1.2

stripIgnoreCase

public static String stripIgnoreCase(CharSequence str,
 CharSequence prefix,
 CharSequence suffix)

去除两边的指定字符串，忽略大小写

参数:

str - 被处理的字符串

prefix - 前缀

suffix - 后缀

返回:

处理后的字符串

从以下版本开始:

3.1.2

startWith

public static boolean startWith(CharSequence str,
 CharSequence prefix)

是否以指定字符串开头

参数:

str - 被监测字符串

prefix - 开头字符串

返回:

是否以指定字符串开头

startWith

public static boolean startWith(CharSequence str,
 CharSequence prefix,
 boolean ignoreCase)

是否以指定字符串开头
如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false

参数:

str - 被监测字符串

prefix - 开头字符串

ignoreCase - 是否忽略大小写

返回:

是否以指定字符串开头

从以下版本开始:

5.4.3

startWith

public static boolean startWith(CharSequence str,
 CharSequence prefix,
 boolean ignoreCase,
 boolean ignoreEquals)

是否以指定字符串开头
如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false

     CharSequenceUtil.startWith("123", "123", false, true);   -- false
     CharSequenceUtil.startWith("ABCDEF", "abc", true, true); -- true
     CharSequenceUtil.startWith("abc", "abc", true, true);    -- false
 

参数:

str - 被监测字符串

prefix - 开头字符串

ignoreCase - 是否忽略大小写

ignoreEquals - 是否忽略字符串相等的情况

返回:

是否以指定字符串开头

从以下版本开始:

5.4.3

startWithIgnoreCase

public static boolean startWithIgnoreCase(CharSequence str,
 CharSequence prefix)

是否以指定字符串开头，忽略大小写

参数:

str - 被监测字符串

prefix - 开头字符串

返回:

是否以指定字符串开头

endWithIgnoreCase

public static boolean endWithIgnoreCase(CharSequence str,
 CharSequence suffix)

是否以指定字符串结尾，忽略大小写

参数:

str - 被监测字符串

suffix - 结尾字符串

返回:

是否以指定字符串结尾

endWith

public static boolean endWith(CharSequence str,
 CharSequence suffix)

是否以指定字符串结尾

参数:

str - 被监测字符串

suffix - 结尾字符串

返回:

是否以指定字符串结尾

endWith

public static boolean endWith(CharSequence str,
 CharSequence suffix,
 boolean ignoreCase)

是否以指定字符串结尾
如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false

参数:

str - 被监测字符串

suffix - 结尾字符串

ignoreCase - 是否忽略大小写

返回:

是否以指定字符串结尾

endWith

public static boolean endWith(CharSequence str,
 CharSequence suffix,
 boolean ignoreCase,
 boolean ignoreEquals)

是否以指定字符串结尾
如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false

参数:

str - 被监测字符串

suffix - 结尾字符串

ignoreCase - 是否忽略大小写

ignoreEquals - 是否忽略字符串相等的情况

返回:

是否以指定字符串结尾

从以下版本开始:

5.8.0