apache common Lang包StringUtils系列(五)

81 public static String[] split(String str, char separatorChar)
功能：使用separatorChar中的字符作为分隔符，分裂提供的文本字符串str。
返回值：
（1）分隔字符不包含在返回的字符串数组中；
（2）相邻的分隔符视为一个分割符；
（3）如果str为null，则返回null；
实例：
 StringUtils.split(null, *)         = null
 StringUtils.split("", *)           = []
 StringUtils.split("a.b.c", '.')    = ["a", "b", "c"]
 StringUtils.split("a..b.c", '.')   = ["a", "b", "c"]
 StringUtils.split("a:b:c", '.')    = ["a:b:c"]
 StringUtils.split("a b c", ' ')    = ["a", "b", "c"]
 
82 public static String[] split(String str,String separatorChars)
功能：使用separatorChars字符串作为分隔符，分裂提供的文本字符串str。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为一个分割符；
（3）如果str为null，则返回null；
（4）如果separatorChars为null，则分隔符视为空白符。
实例：
 StringUtils.split(null, *)         = null
 StringUtils.split("", *)           = []
 StringUtils.split("abc def", null) = ["abc", "def"]
 StringUtils.split("abc def", " ")  = ["abc", "def"]
 StringUtils.split("abc  def", " ") = ["abc", "def"]
 StringUtils.split("ab:cd:ef", ":") = ["ab", "cd", "ef"]
 
83 public static String[] split(String str, String separatorChars, int max)
功能：使用separatorChars字符串作为分隔符，分裂提供的文本字符串str。返回的字符串数组长度最大值为max。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为一个分割符；
（3）如果str为null，则返回null；
（4）如果separatorChars为null，则分隔符视为空白符。
（5）如果分裂出的子串个数大于max，那么最后一个子串包含分裂max-1个子串后剩下的所有字符（包括分隔字符集）；
（6）如果max的值为0或负数，则视为返回数组大小无限制。
实例：
 StringUtils.split(null, *, *)            = null
 StringUtils.split("", *, *)              = []
 StringUtils.split("ab cd ef", null, 0)   = ["ab", "cd", "ef"]
 StringUtils.split("ab   cd ef", null, 0) = ["ab", "cd", "ef"]
 StringUtils.split("ab:cd:ef", ":", 0)    = ["ab", "cd", "ef"]
 StringUtils.split("ab:cd:ef", ":", 2)    = ["ab", "cd:ef"]

84 public static String[] splitByWholeSeparator(String str, String separator)
功能：使用separator整个字符串作为分隔符，分裂提供的文本字符串str。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）如果str为null，则返回null；
（3）如果separator为null，则分隔符视为空白符。
实例：
 StringUtils.splitByWholeSeparator(null, *)               = null
 StringUtils.splitByWholeSeparator("", *)                 = []
 StringUtils.splitByWholeSeparator("ab de fg", null)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab   de fg", null)    = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab:cd:ef", ":")       = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-") = ["ab", "cd", "ef"]
 
85 public static String[] splitByWholeSeparator(String str, String separator, int max)
功能：使用separator整个字符串作为分隔符，分裂提供的文本字符串str。并且返回的字符串数组长度最大值为max。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为一个分割符；
（3）如果str为null，则返回null；
（4）如果separator为null，则分隔符视为空白符。
（5）如果分裂出的子串个数大于max，那么最后一个子串包含分裂max-1个子串后剩下的所有字符（包括分隔字符集）；
（6）如果max的值为0或负数，则视为返回数组大小无限制。
实例：
 StringUtils.splitByWholeSeparator(null, *, *)               = null
 StringUtils.splitByWholeSeparator("", *, *)                 = []
 StringUtils.splitByWholeSeparator("ab de fg", null, 0)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab   de fg", null, 0)    = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab:cd:ef", ":", 2)       = ["ab", "cd:ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 5) = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 2) = ["ab", "cd-!-ef"]
 
86 public static String[] splitByWholeSeparatorPreserveAllTokens(String str, String separator)
功能：使用separator整个字符串作为分隔符，分裂提供的文本字符串str
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为分隔空字符串的一组分隔符；
（3）如果str为null，则返回null；
（4）如果separator为null，则分隔符视为空白符。
实例：
 StringUtils.splitByWholeSeparatorPreserveAllTokens(null, *)               = null
 StringUtils.splitByWholeSeparatorPreserveAllTokens("", *)                 = []
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab de fg", null)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab   de fg", null)    = ["ab", "", "", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab:cd:ef", ":")       = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-") = ["ab", "cd", "ef"]
 
87 public static String[] splitByWholeSeparatorPreserveAllTokens(String str, String separator, int max)
功能：使用separator整个字符串作为分隔符，分裂提供的文本字符串str。并且返回的字符串数组长度最大值为max。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为分隔空字符串的一组分隔符；
（3）如果str为null，则返回null；
（4）如果separator为null，则分隔符视为空白符。
（5）如果分裂出的子串个数大于max，那么最后一个子串包含分裂max-1个子串后剩下的所有字符（包括分隔字符集）；
（6）如果max的值为0或负数，则视为返回数组大小无限制。
实例：
 StringUtils.splitByWholeSeparatorPreserveAllTokens(null, *, *)               = null
 StringUtils.splitByWholeSeparatorPreserveAllTokens("", *, *)                 = []
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab de fg", null, 0)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab   de fg", null, 0)    = ["ab", "", "", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab:cd:ef", ":", 2)       = ["ab", "cd:ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-", 5) = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-", 2) = ["ab", "cd-!-ef"]
 
88 public static String[] splitPreserveAllTokens(String str)
功能：使用空白符分隔提供的文本字符串，保留所有的标识，包括用相邻分隔符分隔的空字符串。
实例：
 StringUtils.splitPreserveAllTokens(null)       = null
 StringUtils.splitPreserveAllTokens("")         = []
 StringUtils.splitPreserveAllTokens("abc def")  = ["abc", "def"]
 StringUtils.splitPreserveAllTokens("abc  def") = ["abc", "", "def"]
 StringUtils.splitPreserveAllTokens(" abc ")    = ["", "abc", ""]
 
89 public static String[] splitPreserveAllTokens(String str, char separatorChar)
功能：使用separatorChar字符作为分隔符分隔提供的文本字符串，保留所有的标识，包括用相邻分隔符分隔的空字符串。
参数：
 str - 源字符串，可以为null
 separatorChar - 作为分隔符, 如果为null则分隔符视为空白符。
实例：
 StringUtils.splitPreserveAllTokens(null, *)         = null
 StringUtils.splitPreserveAllTokens("", *)           = []
 StringUtils.splitPreserveAllTokens("a.b.c", '.')    = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a..b.c", '.')   = ["a", "", "b", "c"]
 StringUtils.splitPreserveAllTokens("a:b:c", '.')    = ["a:b:c"]
 StringUtils.splitPreserveAllTokens("a\tb\nc", null) = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a b c", ' ')    = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a b c ", ' ')   = ["a", "b", "c", ""]
 StringUtils.splitPreserveAllTokens("a b c  ", ' ')   = ["a", "b", "c", "", ""]
 StringUtils.splitPreserveAllTokens(" a b c", ' ')   = ["", a", "b", "c"]
 StringUtils.splitPreserveAllTokens("  a b c", ' ')  = ["", "", a", "b", "c"]
 StringUtils.splitPreserveAllTokens(" a b c ", ' ')  = ["", a", "b", "c", ""]
 
90 public static String[] splitPreserveAllTokens(String str, String separatorChars, int max)
功能：使用separatorChars字符集作为分隔符，分裂提供的文本字符串str。并且返回的字符串数组长度最大值为max。
返回值：
（1）分隔字符串不包含在返回的字符串数组中；
（2）相邻的分隔符视为分隔空字符串的一组分隔符；
（3）如果str为null，则返回null；
（4）如果separatorChars为null，则分隔符视为空白符。
（5）如果分裂出的子串个数大于max，那么最后一个子串包含分裂max-1个子串后剩下的所有字符（包括分隔字符集）；
（6）如果max的值为0或负数，则视为返回数组大小无限制。
实例：
 StringUtils.splitPreserveAllTokens(null, *, *)            = null
 StringUtils.splitPreserveAllTokens("", *, *)              = []
 StringUtils.splitPreserveAllTokens("ab de fg", null, 0)   = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 0) = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef", ":", 0)    = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef", ":", 2)    = ["ab", "cd:ef"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 2) = ["ab", "  de fg"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 3) = ["ab", "", " de fg"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 4) = ["ab", "", "", "de fg"]
 
91 public static String[] splitByCharacterType(String str)
功能：通过字符的类别（java.lang.Character.getType(char)返回值相同的视为同一类字符）解析一个字符串，返回字符串数组。
实例：
 StringUtils.splitByCharacterType(null)         = null
 StringUtils.splitByCharacterType("")           = []
 StringUtils.splitByCharacterType("ab de fg")   = ["ab", " ", "de", " ", "fg"]
 StringUtils.splitByCharacterType("ab   de fg") = ["ab", "   ", "de", " ", "fg"]
 StringUtils.splitByCharacterType("ab:cd:ef")   = ["ab", ":", "cd", ":", "ef"]
 StringUtils.splitByCharacterType("number5")    = ["number", "5"]
 StringUtils.splitByCharacterType("fooBar")     = ["foo", "B", "ar"]
 StringUtils.splitByCharacterType("foo200Bar")  = ["foo", "200", "B", "ar"]
 StringUtils.splitByCharacterType("ASFRules")   = ["ASFR", "ules"]

92 public static String[] splitByCharacterTypeCamelCase(String str)
功能：暂时没弄明白。

93 public static <T> String join(T... elements)
功能：将数组elements中的所有元素拼接成一个独立的字符串。
说明：数组中的null元素或者空字符串都代表空字符串。
实例：
 StringUtils.join(null)            = null
 StringUtils.join([])              = ""
 StringUtils.join([null])          = ""
 StringUtils.join(["a", "b", "c"]) = "abc"
 StringUtils.join([null, "", "a"]) = "a"
 
93 public static String join(Object[] array, char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
说明：
（1）字符separator不能添加到字符串的前面和末尾；
（2）array中的null对象或空字符串都代表空字符串；
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join(["a", "b", "c"], ';')  = "a;b;c"
 StringUtils.join(["a", "b", "c"], null) = "abc"
 StringUtils.join([null, "", "a"], ';')  = ";;a"
 
94 public static String join(long[] array, char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)         = null
 StringUtils.join([], *)           = ""
 StringUtils.join([null], *)       = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"

95 public static String join(int[] array,char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"
 
96 public static String join(short[] array,char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"

97 public static String join(byte[] array,char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"
 
98 public static String join(char[] array, char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"
 
99 public static String join(float[] array, char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)               = null
 StringUtils.join([], *)                 = ""
 StringUtils.join([null], *)             = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"
 
100 public static String join(double[] array, char separator)
功能：将数组array中的所有元素拼接成一个独立的字符串。并将字符separator拼接在元素中间。
返回值：拼接后的字符串，如果数组为null则返回为null。
实例：
 StringUtils.join(null, *)         = null
 StringUtils.join([], *)           = ""
 StringUtils.join([null], *)       = ""
 StringUtils.join([1, 2, 3], ';')  = "1;2;3"
 StringUtils.join([1, 2, 3], null) = "123"