StringUtil (hmtool-core 1.0.0 API)

java.lang.Object
- tech.mhuang.core.util.StringUtil

```
public class StringUtil
extends Object
```
字符串工具类

从以下版本开始:

JDK1.8

版本:

1.0.0

作者:

mhuang

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static int`	`compare(String str1, String str2)` 按照顺序比较两个字符串`String.compareTo(String)`
`static int`	`compare(String str1, String str2, boolean nullIsLess)` 按照顺序比较两个字符串`String.compareTo(String)`
`static boolean`	`containsIgnoreCase(CharSequence str, CharSequence searchStr)` 忽略大小写判断查找的是否在字符对象理
`static boolean`	`equals(CharSequence cs1, CharSequence cs2)` 判断2个字符对象是否相等
`static int`	`indexOf(CharSequence seq, CharSequence searchSeq)` 返回指定子字符串第一次出现的字符串中的索引
`static boolean`	`isBlank(CharSequence cs)` 判断字符串是否为空、判断过程中过滤空格换行符
`static boolean`	`isEmpty(CharSequence cs)` 判断字符串是否是空
`static boolean`	`isEmptyNull(CharSequence cs)` 判断字符串是否是空、并且判断字符串若是"null"也为空
`static boolean`	`isNotBlank(CharSequence cs)` 判断字符串是否不为空、判断过程中过滤空格换行符
`static boolean`	`isNotEmpty(CharSequence cs)` 判断字符串是否不是空
`static boolean`	`isNotEmptyNull(CharSequence cs)` 判断字符串是否不为空、并且判断字符串若是"null"也为空
`static String`	`join(Iterable<?> iterable, CharSequence cs)` 将迭代器根据规则拆分后拼接成一个字符串，并以cs参数隔开
`static String`	`join(Iterator<?> iterator, CharSequence cs)` 将迭代器根据规则拆分后拼接成一个字符串，并以cs参数隔开
`static int`	`length(CharSequence cs)` 获取字符对象的长度
`static String[]`	`split(CharSequence seq, CharSequence splitSeq)` 将字符串分裂成字符串数组.
`static String`	`substringAfter(String str, String separator)` 截取字符串分离之后的字符串
`static String`	`substringBeforeLast(String str, String separator)` 根据字符串截取最后出现的字符串之前
`static String`	`toUpperCaseFirstOne(String s)` 首字母转大写
`static String`	`trim(String str)` 删除空格

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

isEmpty
```
public static boolean isEmpty(CharSequence cs)
```
判断字符串是否是空

参数:

cs - 判断的字符串

返回:

boolean 应答true为空|false不为空

isEmptyNull
```
public static boolean isEmptyNull(CharSequence cs)
```
判断字符串是否是空、并且判断字符串若是"null"也为空

参数:

cs - 判断的字符串

返回:

boolean 应答true为空|false不为空

isNotEmptyNull
```
public static boolean isNotEmptyNull(CharSequence cs)
```
判断字符串是否不为空、并且判断字符串若是"null"也为空

参数:

cs - 判断的字符串

返回:

boolean 应答true不为空|false为空

isNotEmpty
```
public static boolean isNotEmpty(CharSequence cs)
```
判断字符串是否不是空

参数:

cs - 判断的字符串

返回:

boolean 应答true不为空|false为空

isBlank
```
public static boolean isBlank(CharSequence cs)
```
判断字符串是否为空、判断过程中过滤空格换行符

参数:

cs - 判断的字符串

返回:

boolean 应答true为空|false不为空

isNotBlank
```
public static boolean isNotBlank(CharSequence cs)
```
判断字符串是否不为空、判断过程中过滤空格换行符

参数:

cs - 判断的字符串

返回:

应答True不为空|False为空

join
```
public static String join(Iterable<?> iterable,
                          CharSequence cs)
```
将迭代器根据规则拆分后拼接成一个字符串，并以cs参数隔开

参数:

iterable - 迭代器

cs - 拼接的参数

返回:

返回拼接的字符串
特殊情况:

1:若迭代器为空则返回null

2:若迭代器存放的是数据为空则返回null字符串拼接方式

3:若cs为空、则不加入分隔符

join

public static String join(Iterator<?> iterator,
                          CharSequence cs)

将迭代器根据规则拆分后拼接成一个字符串，并以cs参数隔开

参数:

iterator - 迭代器

cs - 拼接的参数

返回:

返回的拼接的字符串

特殊情况

1:若迭代器为空则返回null

2:若迭代器存放的是数据为空则返回null字符串拼接方式

3:若cs为空、则不加入分隔符

     示例：
      StringUtil.join(null, *)                = null
      StringUtil.join([], *)                  = ""
      StringUtil.join([null], *)              = "null"
      StringUtil.join(["a", "b", "c"], "--")  = "a--b--c"
      StringUtil.join(["a", "b", "c"], null)  = "abc"
      StringUtil.join(["a", "b", "c"], "")    = "abc"
      StringUtil.join([null, "", "a"], ',')   = "null,null,a"

substringBeforeLast

public static String substringBeforeLast(String str,
                                         String separator)

根据字符串截取最后出现的字符串之前

参数:

str - 字符串

separator - 截取的字符串

返回:

String 返回截取后的字符串

         示例：
          StringUtil.substringBeforeLast(null, *)      = null
          StringUtil.substringBeforeLast("", *)        = ""
          StringUtil.substringBeforeLast("abcba", "b") = "abc"
          StringUtil.substringBeforeLast("abc", "c")   = "ab"
          StringUtil.substringBeforeLast("a", "a")     = ""
          StringUtil.substringBeforeLast("a", "z")     = "a"
          StringUtil.substringBeforeLast("a", null)    = "a"
          StringUtil.substringBeforeLast("a", "")      = "a"

compare

public static int compare(String str1,
                          String str2)

按照顺序比较两个字符串String.compareTo(String)

参数:

str1 - 要比较的字符串

str2 - 要比较的字符串

返回:

<0, 0, >0 , returning :

int = 0, 如果 str1 等于 str2 (或两者都为 null)
int < 0, 如果 str1 小于 str2
int > 0, 如果 str1 大于str2

  示例：
  StringUtil.compare(null, null)   = 0
  StringUtil.compare(null , "a")   < 0
  StringUtil.compare("a", null)    > 0
  StringUtil.compare("abc", "abc") = 0
  StringUtil.compare("a", "b")     < 0
  StringUtil.compare("b", "a")     > 0
  StringUtil.compare("a", "B")     > 0
  StringUtil.compare("ab", "abc")  < 0

另请参阅:

String.compareTo(String)

compare

public static int compare(String str1,
                          String str2,
                          boolean nullIsLess)

按照顺序比较两个字符串String.compareTo(String)

参数:

str1 - 要比较的字符串

str2 - 要比较的字符串

nullIsLess - 是否认为null值小于非null值

返回:

<0, 0, >0 , returning :

int = 0, 如果 str1 等于 str2 (或两者都为 null)
int < 0, 如果 str1 小于 str2
int > 0, 如果 str1 大于str2

  示例：
 StringUtil.compare(null, null, *)     = 0
 StringUtil.compare(null , "a", true)  < 0
 StringUtil.compare(null , "a", false) > 0
 StringUtil.compare("a", null, true)   > 0
 StringUtil.compare("a", null, false)  < 0
 StringUtil.compare("abc", "abc", *)   = 0
 StringUtil.compare("a", "b", *)       < 0
 StringUtil.compare("b", "a", *)       > 0
 StringUtil.compare("a", "B", *)       > 0
 StringUtil.compare("ab", "abc", *)    < 0

另请参阅:

String.compareTo(String)

trim

public static String trim(String str)

删除空格

参数:

str - 要删除空格的字符串、可以为空

返回:

String 返回删除空格后的字符串

     示例：
          StringUtil.trim(null)          = null
          StringUtil.trim("")            = ""
          StringUtil.trim("     ")       = ""
          StringUtil.trim("abc")         = "abc"
          StringUtil.trim("    abc    ") = "abc"

indexOf

public static int indexOf(CharSequence seq,
                          CharSequence searchSeq)

返回指定子字符串第一次出现的字符串中的索引

参数:

seq - 查找的字符串

searchSeq - 查询字符串的索引

返回:

int 出现的索引

     示例：
          StringUtil.indexOf(null,*)     = -1
          StringUtil.indexOf(*,null)     = -1
          StringUtil.indexOf("","")      = 0
          StringUtil.indexOf("abca","a") = 0
          StringUtil.indexOf("abca","c") = 2

另请参阅:

String.indexOf(String)

split

public static String[] split(CharSequence seq,
                             CharSequence splitSeq)

将字符串分裂成字符串数组.

参数:: seq - 需要分裂的字符串; splitSeq - 分裂的标识
返回:: 数组

equals
```
public static boolean equals(CharSequence cs1,
                             CharSequence cs2)
```
判断2个字符对象是否相等

参数:

cs1 - 第一个字符对象

cs2 - 第二个字符对象

返回:

相等返回True 不相等返回False

toUpperCaseFirstOne
```
public static String toUpperCaseFirstOne(String s)
```
首字母转大写

参数:

s - 转换的字符串

返回:

返回首字母变大写的字符串

containsIgnoreCase
```
public static boolean containsIgnoreCase(CharSequence str,
                                         CharSequence searchStr)
```
忽略大小写判断查找的是否在字符对象理

参数:

str - 字符对象

searchStr - 查找的字符对象

返回:

是否包含忽略大小写的字符串，True包含 False不包含

length
```
public static int length(CharSequence cs)
```
获取字符对象的长度

参数:

cs - 字符对象

返回:

字符对象长度

substringAfter

public static String substringAfter(String str,
                                    String separator)

截取字符串分离之后的字符串

参数:: str - 字符串; separator - 分离的字符串
返回:: 分离后的字符串

类 StringUtil

方法概要

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

方法详细资料

isEmpty

isEmptyNull

isNotEmptyNull

isNotEmpty

isBlank

isNotBlank

join

join

substringBeforeLast

compare

compare

trim

indexOf

split

equals

toUpperCaseFirstOne

containsIgnoreCase

length

substringAfter