[轉]apache Commons commons-lang-2.3 字符串處理類StringUtils.java應用

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 String strip(String str, String stripChars)
去掉str兩端的在stripChars中的字符。
如果str爲null或等於""，則返回它本身；
如果stripChars爲null或""，則返回strip(String str)。

12.public static String stripStart(String str, String stripChars)
和11相似，去掉str前端的在stripChars中的字符。

13.public static String stripEnd(String str, String stripChars)
和11相似，去掉str末端的在stripChars中的字符。

14.public static String[] stripAll(String[] strs)
對字符串數組中的每個字符串進行strip(String str)，然後返回。
如果strs爲null或strs長度爲0，則返回strs本身

15.public static String[] stripAll(String[] strs, String stripChars)
對字符串數組中的每個字符串進行strip(String str, String stripChars)，然後返回。
如果strs爲null或strs長度爲0，則返回strs本身

16.public static boolean equals(String str1, String str2)
比較兩個字符串是否相等，如果兩個均爲空則也認爲相等。

17.public static boolean equalsIgnoreCase(String str1, String str2)
比較兩個字符串是否相等，不區分大小寫，如果兩個均爲空則也認爲相等。

18.public static int indexOf(String str, char searchChar)
返回字符searchChar在字符串str中第一次出現的位置。
如果searchChar沒有在str中出現則返回-1，
如果str爲null或""，則也返回-1

19.public static int indexOf(String str, char searchChar, int startPos)
返回字符searchChar從startPos開始在字符串str中第一次出現的位置。
如果從startPos開始searchChar沒有在str中出現則返回-1，
如果str爲null或""，則也返回-1

20.public static int indexOf(String str, String searchStr)
返回字符串searchStr在字符串str中第一次出現的位置。
如果str爲null或searchStr爲null則返回-1，
如果searchStr爲"",且str爲不爲null，則返回0，
如果searchStr不在str中，則返回-1

21.public static int ordinalIndexOf(String str, String searchStr, int ordinal)
返回字符串searchStr在字符串str中第ordinal次出現的位置。
如果str=null或searchStr=null或ordinal<=0則返回-1
舉例(*代表任意字符串)：
StringUtils.ordinalIndexOf(null, *, *) = -1
StringUtils.ordinalIndexOf(*, null, *) = -1
StringUtils.ordinalIndexOf("", "", *) = 0
StringUtils.ordinalIndexOf("aabaabaa", "a", 1) = 0
StringUtils.ordinalIndexOf("aabaabaa", "a", 2) = 1
StringUtils.ordinalIndexOf("aabaabaa", "b", 1) = 2
StringUtils.ordinalIndexOf("aabaabaa", "b", 2) = 5
StringUtils.ordinalIndexOf("aabaabaa", "ab", 1) = 1
StringUtils.ordinalIndexOf("aabaabaa", "ab", 2) = 4
StringUtils.ordinalIndexOf("aabaabaa", "bc", 1) = -1
StringUtils.ordinalIndexOf("aabaabaa", "", 1) = 0
StringUtils.ordinalIndexOf("aabaabaa", "", 2) = 0

22. public static int indexOf(String str, String searchStr, int startPos)
返回字符串searchStr從startPos開始在字符串str中第一次出現的位置。
舉例(*代表任意字符串)：
StringUtils.indexOf(null, *, *) = -1
StringUtils.indexOf(*, null, *) = -1
StringUtils.indexOf("", "", 0) = 0
StringUtils.indexOf("aabaabaa", "a", 0) = 0
StringUtils.indexOf("aabaabaa", "b", 0) = 2
StringUtils.indexOf("aabaabaa", "ab", 0) = 1
StringUtils.indexOf("aabaabaa", "b", 3) = 5
StringUtils.indexOf("aabaabaa", "b", 9) = -1
StringUtils.indexOf("aabaabaa", "b", -1) = 2
StringUtils.indexOf("aabaabaa", "", 2) = 2
StringUtils.indexOf("abc", "", 9) = 3

23.public static int lastIndexOf(String str, char searchChar)
基本原理同18。

24.public static int lastIndexOf(String str, char searchChar, int startPos)
基本原理同19。

25.public static int lastIndexOf(String str, String searchStr)
基本原理同20。

26.public static int lastIndexOf(String str, String searchStr, int startPos)
基本原理同22。