StringUtils (mzlion-core 1.1.0 API)

java.lang.Object
- com.mzlion.core.lang.StringUtils

```
public class StringUtils
extends Object
```
StringUtils工具类主要提供了针对字符串，字符串数组常用的工具类方法.

作者:

mzlion on 2016-05-05 22:03

字段概要

字段
限定符和类型字段和说明

static String EMPTY_STRING

字段
限定符和类型	字段和说明
`static String`	`EMPTY_STRING`

构造器概要

构造器
构造器和说明

StringUtils()

构造器
构造器和说明
`StringUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static String`	`capitalize(String str)` 将字符串的第一个字符(必须在Character.toUpperCase(char)中，否则就不会改变)转换为大写.
`static String`	`changeCharacterCase(String str, int index, boolean capital)` 将字符串中指定位置(`index`)的字符(必须在Character.toLowerCase(char))转为大(小)写,否则就不会改变 StringUtils.changeCharacterCase("Hello",2,true); //--- "HeLlo"
`static boolean`	`containsWhitespace(CharSequence str)` 判断字符串中是否存在空白符,方法会检查字符串是否为`null` StringUtils.containsWhitespace(null); //--- false StringUtils.containsWhitespace(""); //--- false StringUtils.containsWhitespace(" "); //--- true StringUtils.containsWhitespace("ax x"); //--- true
`static boolean`	`containsWhitespace(String str)` 判断字符串中是否存在空白符,方法会检查字符串是否为`null`
`static String`	`delete(String str, String pattern)` 将字符串`str`中的出现了指定子串`pattern`全部删除,删除的字符串不支持正则表达式.
`static boolean`	`endsWithIgnoreCase(String str, String suffix)` 判断字符串中是否以给定的字符串结尾,不考虑大小写问题.
`static boolean`	`hasLength(CharSequence str)` 判断字符串是否为既不为`null`，字符串长度也不为0.当传入参数是一个空白符时也返回`true` StringUtils.hasLength(null);// --- false StringUtils.hasLength("");// --- false StringUtils.hasLength(" ");// --- true StringUtils.hasLength("Hi");// --- true
`static boolean`	`hasLength(String str)` 判断字符串是否为既不为`null`，字符串长度也不为0.当传入参数是一个空白符时也返回`true`
`static boolean`	`hasText(CharSequence str)` 判断字符串是否存在文本字符，即字符只是存在一个非空白字符。
`static boolean`	`hasText(String str)` 判断字符串是否存在文本字符，即字符只是存在一个非空白字符。
`static boolean`	`isEmpty(CharSequence str)` 判断字符串是否为`null`或空字符串,判断字符串是否为空请使用该方法.
`static boolean`	`isEmpty(String str)` 判断字符串是否为`null`或空字符串,判断字符串是否为空请使用该方法.
`static String`	`replace(String str, String oldPattern, String newPattern)` 将字符串中所有出现`oldPattern`替换为`newPattern`.
`static String[]`	`split(String toSplit)` 字符串分割，默认采用了英文半角逗号分割
`static String[]`	`split(String toSplit, String delimiter)` 字符串分割
`static String[]`	`splitAtFirst(String toSplit, String delimiter)` 从识别的第一处分割字符串
`static boolean`	`startsWithIgnoreCase(String str, String prefix)` 判断字符串中是否以给定的字符串开头，不考虑大小写问题 StringUtils.startsWithIgnoreCase("abcd",null); //--- false StringUtils.startsWithIgnoreCase("abcd","ab"); //--- true StringUtils.startsWithIgnoreCase("abcd","bc"); //--- false StringUtils.startsWithIgnoreCase("abcd","AB"); //--- true StringUtils.startsWithIgnoreCase(null,"ab"); //--- false
`static String`	`toCamelCase(String name)` 将下划线大写方式命名的字符串转换为驼峰式。
`static String`	`toUnderline(String name)` 将驼峰式命名的字符串转换为下划线字符串。
`static String`	`toUnderline(String name, boolean upper)` 将驼峰式命名的字符串转换为下划线字符串。
`static String`	`trim(String str)` 去除字符串左右两侧的空白符 StringUtils.trim(null); //--- null StringUtils.trim(""); //--- "" StringUtils.trim(" "); //--- "" StringUtils.trim(" a b "); //--- a b
`static String`	`trimLeftWhiteSpace(String str)` 去除字符串左侧的空白字符 StringUtils.trimLeftWhiteSpace(null); //--- null StringUtils.trimLeftWhiteSpace("ab"); //--- null StringUtils.trimLeftWhiteSpace((" ab c");//--- ab c
`static String`	`trimRightWhiteSpace(String str)` 去除字符串右侧的空白字符 StringUtils.trimRightWhiteSpace(null); //--- null StringUtils.trimRightWhiteSpace("ab"); //--- null StringUtils.trimRightWhiteSpace((" ab c ");//--- ab c
`static String`	`unCapitalize(String str)` 将字符串的第一个字符(必须在Character.toLowerCase(char)中，否则就不会改变)转换为小写.

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

- 字段详细资料
  - EMPTY_STRING
```
public static final String EMPTY_STRING
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - StringUtils
```
public StringUtils()
```
- 方法详细资料
  - isEmpty
```
public static boolean isEmpty(CharSequence str)
```
    判断字符串是否为null或空字符串,判断字符串是否为空请使用该方法.
    
    参数:
    
    str - 字符串
    
    返回:
    
    如果字符串是或空字符串则返回true，否则返回false
  - isEmpty
```
public static boolean isEmpty(String str)
```
    判断字符串是否为null或空字符串,判断字符串是否为空请使用该方法.
    
    参数:
    
    str - 字符串
    
    返回:
    
    如果字符串是或空字符串则返回true，否则返回false
  - hasLength
```
public static boolean hasLength(CharSequence str)
```
    判断字符串是否为既不为null，字符串长度也不为0.当传入参数是一个空白符时也返回true
```
 StringUtils.hasLength(null);// --- false
 StringUtils.hasLength("");// --- false
 StringUtils.hasLength(" ");// --- true
 StringUtils.hasLength("Hi");// --- true
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    当且仅当字符串类型不为null,长度也不为0时就返回true,反之则返回false.
  - hasLength
```
public static boolean hasLength(String str)
```
    判断字符串是否为既不为null，字符串长度也不为0.当传入参数是一个空白符时也返回true
    
    参数:
    
    str - 字符串
    
    返回:
    
    当且仅当字符串类型不为null,长度也不为0时就返回true,反之则返回false.
    
    另请参阅:
    
    hasLength(CharSequence)
  - hasText
```
public static boolean hasText(CharSequence str)
```
    判断字符串是否存在文本字符，即字符只是存在一个非空白字符。
```
  StringUtils.hasText(null); //--- false
  StringUtils.hasText(""); //--- false
  StringUtils.hasText(" "); //--- false
  StringUtils.hasText(" abc"); //--- true
  StringUtils.hasText("a"); //--- true
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    当字符串至少存在一个不为空白字符时返回true,否则返回false
    
    另请参阅:
    
    Character.isWhitespace(char)
  - hasText
```
public static boolean hasText(String str)
```
    判断字符串是否存在文本字符，即字符只是存在一个非空白字符。
    
    参数:
    
    str - 字符串
    
    返回:
    
    当字符串至少存在一个不为空白字符时返回true,否则返回false
    
    另请参阅:
    
    hasText(CharSequence)
  - containsWhitespace
```
public static boolean containsWhitespace(CharSequence str)
```
    判断字符串中是否存在空白符,方法会检查字符串是否为null
```
 StringUtils.containsWhitespace(null); //--- false
 StringUtils.containsWhitespace(""); //--- false
 StringUtils.containsWhitespace(" "); //--- true
 StringUtils.containsWhitespace("ax x"); //--- true
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    当字符串存在一个空白符时就返回true,否则返回false
    
    另请参阅:
    
    Character.isWhitespace(char)
  - containsWhitespace
```
public static boolean containsWhitespace(String str)
```
    判断字符串中是否存在空白符,方法会检查字符串是否为null
    
    参数:
    
    str - 字符串
    
    返回:
    
    当字符串存在一个空白符时就返回true,否则返回false
    
    另请参阅:
    
    containsWhitespace(CharSequence)
  - trim
```
public static String trim(String str)
```
    去除字符串左右两侧的空白符
```
  StringUtils.trim(null); //--- null
  StringUtils.trim(""); //--- ""
  StringUtils.trim("    "); //--- ""
  StringUtils.trim("  a b  "); //--- a b
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    返回已经去除左右两边的空白的字符串
    
    另请参阅:
    
    Character.isWhitespace(char)
  - trimLeftWhiteSpace
```
public static String trimLeftWhiteSpace(String str)
```
    去除字符串左侧的空白字符
```
 StringUtils.trimLeftWhiteSpace(null); //--- null
 StringUtils.trimLeftWhiteSpace("ab"); //--- null
 StringUtils.trimLeftWhiteSpace(("  ab c");//--- ab c
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    返回去除后的字符串
  - trimRightWhiteSpace
```
public static String trimRightWhiteSpace(String str)
```
    去除字符串右侧的空白字符
```
 StringUtils.trimRightWhiteSpace(null); //--- null
 StringUtils.trimRightWhiteSpace("ab"); //--- null
 StringUtils.trimRightWhiteSpace((" ab c   ");//---  ab c
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    返回去除后的字符串
  - startsWithIgnoreCase
```
public static boolean startsWithIgnoreCase(String str,
                                           String prefix)
```
    判断字符串中是否以给定的字符串开头，不考虑大小写问题
```
 StringUtils.startsWithIgnoreCase("abcd",null); //--- false
 StringUtils.startsWithIgnoreCase("abcd","ab"); //--- true
 StringUtils.startsWithIgnoreCase("abcd","bc"); //--- false
 StringUtils.startsWithIgnoreCase("abcd","AB"); //--- true
 StringUtils.startsWithIgnoreCase(null,"ab"); //--- false
 
```
    参数:
    
    str - 字符串
    
    prefix - 给定的字符串，以该字符串开头
    
    返回:
    
    如果字符串{code str}是以prefix开头(忽略大小写)则返回true,否则返回false
  - endsWithIgnoreCase
```
public static boolean endsWithIgnoreCase(String str,
                                         String suffix)
```
    判断字符串中是否以给定的字符串结尾,不考虑大小写问题.
```
 StringUtils.endsWithIgnoreCase("ddcbab",null); //--- false
 StringUtils.endsWithIgnoreCase("ddcbab","ab"); //--- true
 StringUtils.endsWithIgnoreCase("ddcbab","bc"); //--- false
 StringUtils.endsWithIgnoreCase("ddcbab","AB"); //--- true
 StringUtils.endsWithIgnoreCase(null,"ab"); //--- false
 
```
    参数:
    
    str - 字符串
    
    suffix - 给定的字符串，以该字符串开头
    
    返回:
    
    如果字符串{code str}是以prefix开头(忽略大小写)则返回true,否则返回false
    
    另请参阅:
    
    String.endsWith(String)
  - replace
```
public static String replace(String str,
                             String oldPattern,
                             String newPattern)
```
    将字符串中所有出现oldPattern替换为newPattern.
```
 StringUtils.replace("com.mzlion.utility.","l","x"); //--- "hexxo worxd"
 
```
    参数:
    
    str - 字符串
    
    oldPattern - 需要替换的字符串
    
    newPattern - 新的字符串
    
    返回:
    
    返回替换后的字符串
  - delete
```
public static String delete(String str,
                            String pattern)
```
    将字符串str中的出现了指定子串pattern全部删除,删除的字符串不支持正则表达式.
```
 StringUtils.delete("hello world","l"); //--- "heo word";
 
```
    参数:
    
    str - 字符串
    
    pattern - 要删除的字符串
    
    返回:
    
    返回删除后的字符串
  - capitalize
```
public static String capitalize(String str)
```
    将字符串的第一个字符(必须在Character.toUpperCase(char)中，否则就不会改变)转换为大写.
```
 StringUtils.capitalize("she si just a kid"); //--- "She is just a kid"
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    返回字符串中的第一个字符转换为大写
  - unCapitalize
```
public static String unCapitalize(String str)
```
    将字符串的第一个字符(必须在Character.toLowerCase(char)中，否则就不会改变)转换为小写.
```
 StringUtils.unCapitalize("Hello"); //--- "hello"
 
```
    参数:
    
    str - 字符串
    
    返回:
    
    返回字符串中的第一个字符转换为小写
  - changeCharacterCase
```
public static String changeCharacterCase(String str,
                                         int index,
                                         boolean capital)
```
    将字符串中指定位置(index)的字符(必须在Character.toLowerCase(char))转为大(小)写,否则就不会改变
```
 StringUtils.changeCharacterCase("Hello",2,true); //--- "HeLlo"
 
```
    参数:
    
    str - 字符串
    
    index - 大小写更改位置
    
    capital - 大写还是小写，当值为true时则大写，值为false时则小写
    
    返回:
    
    返回修改后的字符串
  - splitAtFirst
```
public static String[] splitAtFirst(String toSplit,
                                    String delimiter)
```
    从识别的第一处分割字符串
    
    参数:
    
    toSplit - 要分隔的字符串
    
    delimiter - 分隔符
    
    返回:
    
    返回分割后的字符串数组
  - split
```
public static String[] split(String toSplit)
```
    字符串分割，默认采用了英文半角逗号分割
    
    参数:
    
    toSplit - 待分割的字符串
    
    返回:
    
    分割后的字符串数组
    
    另请参阅:
    
    split(String, String)
  - split
```
public static String[] split(String toSplit,
                             String delimiter)
```
    字符串分割
    
    参数:
    
    toSplit - 要分隔的字符串
    
    delimiter - 分隔符
    
    返回:
    
    分割后的字符串数组
    
    另请参阅:
    
    StringTokenizer
  - toUnderline
```
public static String toUnderline(String name)
```
    将驼峰式命名的字符串转换为下划线字符串。如果转换前的驼峰式命名的字符串为空，则返回空字符串。
```
     例如：HelloWorld to hello_world
 
```
    参数:
    
    name - 驼峰式的字符串
    
    返回:
    
    返回下划线式的字符串
  - toUnderline
```
public static String toUnderline(String name,
                                 boolean upper)
```
    将驼峰式命名的字符串转换为下划线字符串。如果转换前的驼峰式命名的字符串为空，则返回空字符串。
    
    参数:
    
    name - 驼峰式的字符串
    
    upper - 如果为true则将字符串均转为大写
    
    返回:
    
    返回下划线的字符串
  - toCamelCase
```
public static String toCamelCase(String name)
```
    将下划线大写方式命名的字符串转换为驼峰式。如果转换前的下划线大写方式命名的字符串为空，则返回空字符串。
```
     例如：HELLO_WORLD - helloWorld
 
```
    参数:
    
    name - 下划线式字符串
    
    返回:
    
    返回驼峰式字符串

类 StringUtils

字段概要

构造器概要

方法概要

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

字段详细资料

EMPTY_STRING

构造器详细资料

StringUtils

方法详细资料

isEmpty

isEmpty

hasLength

hasLength

hasText

hasText

containsWhitespace

containsWhitespace

trim

trimLeftWhiteSpace

trimRightWhiteSpace

startsWithIgnoreCase

endsWithIgnoreCase

replace

delete

capitalize

unCapitalize

changeCharacterCase

splitAtFirst

split

split

toUnderline

toUnderline

toCamelCase