StringUtils工具類的常用方法

最近在寫代碼的時候對字元串的處理比較多，尤其是在判斷條件時候有時候不嚴謹就會抛異常，而且也比較備援的感覺，網上看到一篇關于StringUtils工具類使用方法的介紹，感覺挺不錯，收藏下來以後備用 

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 判斷是否為空的示例：

StringUtils.isEmpty(null) = true

StringUtils.isEmpty("") = true 

StringUtils.isEmpty(" ") = false //注意在 StringUtils 中空格作非空處理

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()   //均識為空白符

      StringUtils.isBlank("\b") = false   //"\b"為單詞邊界符

      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(" ") = ""

以下方法隻介紹其功能，不再舉例：

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) ，然後傳回。

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，

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