apache Commons commons-lang StringUtils.java

StringUtils中方法的操作对象是java.lang.String类型的对象，是JDK提供的String类型操作方法的补充，并且是null安全的(即如果输入参数String为null则不会抛出NullPointerException，而是做了相应处理，例如，如果输入为null则返回也是null等，具体可以查看源代码)。

除了构造器，StringUtils中一共有130多个方法，并且都是static的，
所以我们可以这样调用StringUtils.xxx()。

下面分别对一些常用方法做简要介绍：

1. public static boolean isEmpty(String str)
判断某字符串是否为空，为空的标准是str == null 或 str.length() == 0
下面是示例：
StringUtils.isEmpty(null)          = true
StringUtils.isEmpty("")       = true
StringUtils.isEmpty(" ")      = false
StringUtils.isEmpty("        ")     = false
StringUtils.isEmpty("bob")       = false
StringUtils.isEmpty(" bob ") = false

2. public static boolean isNotEmpty(String str)
判断某字符串是否非空，等于!isEmpty(String str)
下面是示例：
StringUtils.isNotEmpty(null)        = false
StringUtils.isNotEmpty("")           = false
StringUtils.isNotEmpty(" ")      = true
StringUtils.isNotEmpty("         ")    = true
StringUtils.isNotEmpty("bob")   = true
StringUtils.isNotEmpty(" bob ")   = true

3. public static boolean isBlank(String str)
判断某字符串是否为空或长度为0或由空白符(whitespace)构成
下面是示例：
StringUtils.isBlank(null)         = true
StringUtils.isBlank("")            = true
StringUtils.isBlank(" ")                 = true
StringUtils.isBlank("        ")          = true
StringUtils.isBlank("\t \n \f \r")    = true
StringUtils.isBlank("\b")               = false
StringUtils.isBlank("bob")            = false
StringUtils.isBlank(" bob ")        = false

4. public static boolean isNotBlank(String str)
判断某字符串是否不为空且长度不为0且不由空白符(whitespace)构成，
等于!isBlank(String str)
下面是示例：
StringUtils.isNotBlank(null)        = false
StringUtils.isNotBlank("")               = false
StringUtils.isNotBlank(" ")          = false
StringUtils.isNotBlank("         ")        = false
StringUtils.isNotBlank("\t \n \f \r")     = false
StringUtils.isNotBlank("\b")              = true
StringUtils.isNotBlank("bob")           = true
StringUtils.isNotBlank(" bob ")   = true

5. public static String trim(String str)
去掉字符串两端的控制符(control characters, char <= 32)
如果输入为null则返回null
下面是示例：
StringUtils.trim(null)                = null
StringUtils.trim("")                 = ""
StringUtils.trim(" ")                          = ""
StringUtils.trim("     \b \t \n \f \r    ") = ""
StringUtils.trim("     \n\tss   \b")        = "ss"
StringUtils.trim(" d   d dd     ")     = "d   d dd"
StringUtils.trim("dd     ")            = "dd"
StringUtils.trim("     dd       ")           = "dd"

6.public static String trimToNull(String str)
去掉字符串两端的控制符(control characters, char <= 32)
如果变为null或""，则返回null
下面是示例：
StringUtils.trimToNull(null)                = null
StringUtils.trimToNull("")                           = null
StringUtils.trimToNull(" ")                          = null
StringUtils.trimToNull("     \b \t \n \f \r    ") = null
StringUtils.trimToNull("     \n\tss   \b")     = "ss"
StringUtils.trimToNull(" d   d dd     ")        = "d   d dd"
StringUtils.trimToNull("dd     ")           = "dd"
StringUtils.trimToNull("     dd       ")          = "dd"

7.public static String trimToEmpty(String str)
去掉字符串两端的控制符(control characters, char <= 32)
如果变为null或""，则返回""
下面是示例：
StringUtils.trimToEmpty(null)                    = ""
StringUtils.trimToEmpty("")                   = ""
StringUtils.trimToEmpty(" ")                          = ""
StringUtils.trimToEmpty("     \b \t \n \f \r    ") = ""
StringUtils.trimToEmpty("     \n\tss   \b")     = "ss"
StringUtils.trimToEmpty(" d   d dd     ")      = "d   d dd"
StringUtils.trimToEmpty("dd     ")             = "dd"
StringUtils.trimToEmpty("     dd       ")          = "dd"

8.public static String strip(String str)
去掉字符串两端的空白符(whitespace)，
如果输入为null则返回null
下面是示例(注意和trim()的区别)：
StringUtils.strip(null)                    = null
StringUtils.strip("")                   = ""
StringUtils.strip(" ")                  = ""
StringUtils.strip("     \b \t \n \f \r    ")        = "\b"
StringUtils.strip("     \n\tss   \b")             = "ss   \b"
StringUtils.strip(" d   d dd     ")      = "d   d dd"
StringUtils.strip("dd     ")             = "dd"
StringUtils.strip("     dd       ")          = "dd"

9.public static String stripToNull(String str)
去掉字符串两端的空白符(whitespace)，
如果变为null或""，则返回null
下面是示例(注意和trimToNull()的区别)：
StringUtils.stripToNull(null)                   = null
StringUtils.stripToNull("")                    = null
StringUtils.stripToNull(" ")                 = null
StringUtils.stripToNull("     \b \t \n \f \r    ") = "\b"
StringUtils.stripToNull("     \n\tss   \b")       = "ss   \b"
StringUtils.stripToNull(" d   d dd     ")       = "d   d dd"
StringUtils.stripToNull("dd     ")                 = "dd"
StringUtils.stripToNull("     dd       ")          = "dd"

10.public static String stripToEmpty(String str)
去掉字符串两端的空白符(whitespace)，
如果变为null或""，则返回""
下面是示例(注意和trimToEmpty()的区别)：
StringUtils.stripToNull(null)                  = ""
StringUtils.stripToNull("")                   = ""
StringUtils.stripToNull(" ")                  = ""
StringUtils.stripToNull("     \b \t \n \f \r    ")   = "\b"
StringUtils.stripToNull("     \n\tss   \b")     = "ss   \b"
StringUtils.stripToNull(" d   d dd     ")     = "d   d dd"
StringUtils.stripToNull("dd     ")                 = "dd"
StringUtils.stripToNull("     dd       ")           = "dd"
11.public static boolean contains(String str, char searchChar)
判断字符串str中是否包含字符searchChar。
如果str为null或""，返回false；
如果searchChar不在str中，返回false。

12.public static boolean contains(String str, String searchStr)
判断字符串str是否包含字符串searchStr。
如果str为null或searchStr为null，返回false；
如果str为""，并且searchStr为""，返回true
举例：
StringUtils.contains("", "")       = true
StringUtils.contains("dfg", "")    = true
StringUtils.contains("dfg", "d")   = true
StringUtils.contains("dfg", "gz") = false

13.public static boolean containsIgnoreCase(String str, String searchStr)
判断字符串str是否包含字符串searchStr，不区分大小写。
和12类似。

14.public static int indexOfAny(String str, char[] searchChars)
找出字符数组searchChars中的字符第一次出现在字符串str中的位置。
如果字符数组中的字符都不在字符串中，则返回-1
如果字符串为null或""，则返回-1
举例(*表示任意)：
StringUtils.indexOfAny(null, *)                 = -1
StringUtils.indexOfAny("", *)                   = -1
StringUtils.indexOfAny(*, [])                   = -1
StringUtils.indexOfAny("asdf", ['a','f',' '])   = 0
StringUtils.indexOfAny("bs df", ['a','f',' ']) = 2
StringUtils.indexOfAny("bsdf", ['a','f',' '])   = 3
StringUtils.indexOfAny("bbeegg", ['a','f',' ']) = -1

15.public static int indexOfAny(String str, String searchChars)
找出字符串searchChars中的字符第一次出现在字符串str中的位置。
如果字符串searchChars中的字符都不在字符串str中，则返回-1
如果searchChars或str为null或为""，则返回-1
举例(*表示任意)：
StringUtils.indexOfAny(null, *)         = -1
StringUtils.indexOfAny("", *)           = -1
StringUtils.indexOfAny(*, null)         = -1
StringUtils.indexOfAny(*, "")           = -1
StringUtils.indexOfAny("asdf", "af ")   = 0
StringUtils.indexOfAny("bs df", "af ") = 2
StringUtils.indexOfAny("bsdf", "af ")   = 3
StringUtils.indexOfAny("bbeegg", "af ") = -1

16.public static int indexOfAnyBut(String str, char[] searchChars)
找出字符串str中不在字符数组searchChars中的第一个字符的位置。
如果字符串中的所有字符都在字符数组中，则返回-1
如果字符串为null或""，则返回-1
举例(*表示任意)：
StringUtils.indexOfAnyBut(null, *)                 = -1
StringUtils.indexOfAnyBut("", *)                   = -1
StringUtils.indexOfAnyBut(*, [])                   = -1
StringUtils.indexOfAnyBut("asdf", ['a','f',' '])   = 1
StringUtils.indexOfAnyBut("bs df", ['a','f',' ']) = 0
StringUtils.indexOfAnyBut(" aaf", ['a','f',' '])   = -1
StringUtils.indexOfAnyBut("bbeegg", ['a','f',' ']) = 0

17.public static int indexOfAnyBut(String str, String searchChars)
找出字符串str中不在字符串searchChars中的第一个字符的位置。
如果字符串str中的所有字符都在字符串searchChars中，则返回-1
如果字符串str或searchChars为null或""，则返回-1
举例(*表示任意)：
StringUtils.indexOfAnyBut(null, *)         = -1
StringUtils.indexOfAnyBut("", *)           = -1
StringUtils.indexOfAnyBut(*, null)         = -1
StringUtils.indexOfAnyBut(*, "")           = -1
StringUtils.indexOfAnyBut("asdf", "af ")   = 1
StringUtils.indexOfAnyBut("bs df", "af ") = 0
StringUtils.indexOfAnyBut(" aaf", "af ")   = -1
StringUtils.indexOfAnyBut("bbeegg", "af ") = 0

18.public static boolean containsOnly(String str, char[] valid)
判断是否字符串str仅包含字符数组valid中的字符，即字符串中的字符是否都在字符数组中。
如果str为null，则返回false；如果str为""，则返回true
举例(*表示任意)：
StringUtils.containsOnly(null, *))              = false
StringUtils.containsOnly("", *))                = true
StringUtils.containsOnly("afaf", ['a','f',' ']))= true
StringUtils.containsOnly("af a", ['a','f',' ']))= true
StringUtils.containsOnly("a", ['a','f',' ']))   = true
StringUtils.containsOnly("afg", ['a','f',' '])) = false
StringUtils.containsOnly("bbeegg", []))         = false

19.public static boolean containsOnly(String str, String validChars)
判断是否字符串str仅包含字符串validChars中的字符，
即字符串str中的字符是否都在字符串validChars中。
和18类似，举例(*表示任意)：
StringUtils.containsOnly(null, *)       = false
StringUtils.containsOnly(*, null)       = false
StringUtils.containsOnly("", "")        = true
StringUtils.containsOnly("", "a")       = true
StringUtils.containsOnly("afaf", "af ") = true
StringUtils.containsOnly("af a", "af ") = true
StringUtils.containsOnly("afg", "af ") = false
StringUtils.containsOnly("afg", "")     = false

20.public static boolean containsNone(String str, char[] invalidChars)
判断是否字符串str不包含字符数组invalidChars中的字符，如果含有则返回false。
举例(*表示任意)：
StringUtils.containsNone(null, *)               = true
StringUtils.containsNone(*, [])                 = true
StringUtils.containsNone("", *)                 = true
StringUtils.containsNone("ab", [])              = true
StringUtils.containsNone("b", ['a','f',' '])    = true
StringUtils.containsNone("bcd", ['a','f',' ']) = true
StringUtils.containsNone("abc", ['a','f',' ']) = false
StringUtils.containsNone(" ", ['a','f',' '])    = false

21.public static boolean containsNone(String str, String invalidChars)
判断是否字符串str不包含字符串invalidChars中的字符，如果含有则返回false。
举例(*表示任意)：
StringUtils.containsNone(null, *)       = true
StringUtils.containsNone(*, null)       = true
StringUtils.containsNone("", *)         = true
StringUtils.containsNone("ab", "")      = true
StringUtils.containsNone("b", "af ")    = true
StringUtils.containsNone("bcd", "af ") = true
StringUtils.containsNone("abc", "af ") = false
StringUtils.containsNone(" ", "af ")    = false