apache commons-lang-2.3 StringUtils.java 学习笔记(3)

36.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

37.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

38.public static int indexOfAny(String str, String[] searchStrs)
找出字符串数组searchStrs中的字符串第一次出现在字符串str中的位置。
如果数组中没有字符串在str中，则返回-1
如果数组为null或长度为0，则返回-1
举例(*表示任意)：
StringUtils.indexOfAny(null, *) = -1
StringUtils.indexOfAny(*, null) = -1
StringUtils.indexOfAny(*, []) = -1
StringUtils.indexOfAny("", [""]) = 0
StringUtils.indexOfAny("bbeegg", ["as","df","yy"]) = -1
StringUtils.indexOfAny("asdfgh", ["as","df","yy"]) = 0
StringUtils.indexOfAny("dfasgh", ["as","df","yy"]) = 0
StringUtils.indexOfAny("ghasdf", ["as","df","yy"]) = 2

39.public static int lastIndexOfAny(String str, String[] searchStrs)
找出字符串数组searchStrs中的字符串最后一次出现在字符串str中的位置。
如果数组中没有字符串在str中，则返回-1
如果数组为null或长度为0，则返回-1
举例(*表示任意)：
StringUtils.lastIndexOfAny(null, *) = -1
StringUtils.lastIndexOfAny(*, null) = -1
StringUtils.lastIndexOfAny(*, []) = -1
StringUtils.lastIndexOfAny("", [""]) = 0
StringUtils.lastIndexOfAny("bbeegg", ["as","df","yy"]) = -1
StringUtils.lastIndexOfAny("asdfgh", ["as","df","yy"]) = 2
StringUtils.lastIndexOfAny("dfghjk", ["as","df","yy"]) = 0
StringUtils.lastIndexOfAny("ghasdf", ["as","df","yy"]) = 4
StringUtils.lastIndexOfAny("ghasdf", ["as","df",""]) = 6

40.public static String substring(String str, int start)
得到字符串str的子串。
如果start小于0，位置是从后往前数的第|start|个
如果str为null或""，则返回它本身
举例(*表示任意)：
StringUtils.substring(null, *) = null
StringUtils.substring("", *) = ""
StringUtils.substring("asdf", 0)) = "asdf"
StringUtils.substring("asdf", 1)) = "sdf"
StringUtils.substring("asdf", 3)) = "f"
StringUtils.substring("asdf", 8)) = ""
StringUtils.substring("asdf", -1)) = "f"
StringUtils.substring("asdf", -3)) = "sdf"
StringUtils.substring("asdf", -8)) = "asdf"

41.public static String substring(String str, int start, int end)
得到字符串str的子串。
如果start小于0，位置是从后往前数的第|start|个，
如果end小于0，位置是从后往前数的第|end|个，
如果str为null或""，则返回它本身
举例(*表示任意)：
StringUtils.substring(null, *, *) = null
StringUtils.substring("", * , *) = "";
StringUtils.substring("asdf", 0, 2) = "as"
StringUtils.substring("asdf", 0, -1) = "asd"
StringUtils.substring("asdf", 2, -1) = "d"
StringUtils.substring("asdf", 2, -2) = ""
StringUtils.substring("asdf", 3, 2) = ""
StringUtils.substring("asdf", 1, 8) = "sdf"
StringUtils.substring("asdf", -1, -3) = ""
StringUtils.substring("asdf", -3, -1) = "sd"
StringUtils.substring("asdf", -8, 5) = "asdf"

42.public static String left(String str, int len)
得到字符串str从左边数len长度的子串。
如果str为null或为""，则返回它本身
如果len小于0，则返回""
举例(*表示任意)：
StringUtils.left(null, *) = null
StringUtils.left(*, -ve) = ""
StringUtils.left("", *) = ""
StringUtils.left("asdf", 0) = ""
StringUtils.left("asdf", 2) = "as"
StringUtils.left("asdf", 8) = "asdf"

43.public static String right(String str, int len)
得到字符串str从右边数len长度的子串。
如果str为null或为""，则返回它本身
如果len小于0，则返回""
举例(*表示任意)：
StringUtils.right(null, *) = null
StringUtils.right(*, -ve) = ""
StringUtils.right("", *) = ""
StringUtils.right("asdf", 0) = ""
StringUtils.right("asdf", 2) = "df"
StringUtils.right("asdf", 8) = "asdf"

44.public static String mid(String str, int pos, int len)
得到字符串str从pos开始len长度的子串。
如果str为null或为""，则返回它本身
如果len小于0或pos大于srt的长度，则返回""
如果pos小于0，则pos设为0
举例(*表示任意)：
StringUtils.mid(null, *, *) = null
StringUtils.mid("", *, *) = ""
StringUtils.mid(*, *, -ve) = ""
StringUtils.mid("asdf", 0, 4)) = "asdf"
StringUtils.mid("asdf", 2, 2)) = "df"
StringUtils.mid("asdf", 2, 5)) = "df"
StringUtils.mid("asdf", -2, 1)) = "a"
StringUtils.mid("asdf", 0, -1)) = ""

45.public static String substringBefore(String str, String separator)
得到字符串str的在字符串separator出现前的字串，且separator不包括在内。
如果str为null或为""，则返回它本身
如果separator为null，则返回str本身
举例(*表示任意)：
StringUtils.substringBefore(null, *) = null
StringUtils.substringBefore("", *) = ""
StringUtils.substringBefore("asdfg", null)) = "asdfg"
StringUtils.substringBefore("asdfg", "a")) = ""
StringUtils.substringBefore("asdfg", "sd")) = "a"
StringUtils.substringBefore("asdfsag", "sa")) = "asdf"
StringUtils.substringBefore("asdfg", "h")) = "asdfg"
StringUtils.substringBefore("asdfg", "")) = ""
StringUtils.substringBefore("asdfg", "dfgh")) = "asdfg"
StringUtils.substringBefore("asdfg", "dfg")) = "as"
StringUtils.substringBefore("abbbabbba", "bb")) = "a"

46.public static String substringAfter(String str, String separator)
得到字符串str的在字符串separator出现后的字串，且separator不包括在内。
如果str为null或为""，则返回它本身
如果separator为null，则返回""
举例(*表示任意)：
StringUtils.substringAfter(null, *) = null
StringUtils.substringAfter("", *) = ""
StringUtils.substringAfter(*, null) = ""
StringUtils.substringAfter("asdfg", "a")) = "sdfg"
StringUtils.substringAfter("asdfg", "sd")) = "fg"
StringUtils.substringAfter("asdfsag", "sa")) = "g"
StringUtils.substringAfter("asdfg", "h")) = ""
StringUtils.substringAfter("asdfg", "")) = "asdfg"
StringUtils.substringAfter("asdfg", "dfgh")) = ""
StringUtils.substringAfter("asdfg", "dfg")) = ""
StringUtils.substringAfter("abbbabbba", "bb"))= "babbba"

47.public static String substringBeforeLast(String str, String separator)
和45类似，得到字符串str的在字符串separator最后一次出现前的字串。
这里不再举例。

48.public static String substringAfterLast(String str, String separator)
和46类似，得到字符串str的在字符串separator最后一次出现后的字串。
这里不再举例。

49.public static String substringBetween(String str, String tag)
得到str中的在两个字符串tag中间的字符串，即str中的tag所夹的串。
如果str为null或tag为null，返回null
举例(*表示任意)：
StringUtils.substringBetween(null, *) = null
StringUtils.substringBetween(*, null) = null
StringUtils.substringBetween("", "") = ""
StringUtils.substringBetween("", "a")) = null
StringUtils.substringBetween("asdfdf", "df")) = ""
StringUtils.substringBetween("asdfas", "as")) = "df"
StringUtils.substringBetween("dfasdfasdfas", "df")) = "as"
StringUtils.substringBetween("dfasdfasdfas", "as")) = "df"
StringUtils.substringBetween("dfasdfasgdf", "df")) = "as"

50.public static String substringBetween(String str, String open, String close)
得到str中的在两个字符串open和close中间的字符串，即open和close所夹的串。
如果str为null或open为null或close为null，返回null
举例(*表示任意)：
StringUtils.substringBetween(null, *, *) = null
StringUtils.substringBetween(*, null, *) = null
StringUtils.substringBetween(*, *, null) = null
StringUtils.substringBetween("", "", "") = ""
StringUtils.substringBetween("", "", "]") = null
StringUtils.substringBetween("", "[", "]") = null
StringUtils.substringBetween("[]", "[","]")) = ""
StringUtils.substringBetween("a[sd]f", "[","]")) = "sd"
StringUtils.substringBetween("a[sd]f[gh]", "[","]")) = "sd"
StringUtils.substringBetween("a[sd]f", "]","[")) = null
StringUtils.substringBetween("a[sd]f", "","")) = ""

51.public static String[] substringsBetween(String str, String open, String close)
得到str中的在两个字符串open和close中间的字符串，即open和close所夹的串，
把所有符合的结果放在数组中返回。
和50类似，但是返回了所有的结果(50只返回了第一个匹配的结果)。
这里不再举例。

52.public static String[] split(String str)
把字符串拆分成一个字符串数组，用空白符(whitespace)作为分隔符。
Whitespace是这样定义的 {@link Character#isWhitespace(char)}
如果字符串为null，返回null
如果字符串为""，返回空数组{}
举例(*表示任意)：
StringUtils.split(null) = null
StringUtils.split("") = {}
StringUtils.split("as df yy")) = {"as","df","yy"}
StringUtils.split(" as df yy ")) = {"as","df","yy"}
StringUtils.split("as\ndf\ryy")) = {"as","df","yy"}
StringUtils.split("as\tdf\fyy")) = {"as","df","yy"}
StringUtils.split("as df \fyy")) = {"as","df","yy"}
StringUtils.split("as\t \r df \f \n yy")) = {"as","df","yy"}
StringUtils.split("as")) = {"as"}
StringUtils.split(" as ")) = {"as"}

53.public static String[] split(String str, char separatorChar)
把字符串拆分成一个字符串数组，用指定的字符separatorChar作为分隔符。
如果字符串为null，返回null
如果字符串为""，返回空数组{}
举例(*表示任意)：
StringUtils.split(null, *) = null
StringUtils.split("", *) = {}
StringUtils.split("as df yy",' ')) = {"as","df","yy"}
StringUtils.split(" as df yy ",' ')) = {"as","df","yy"}
StringUtils.split("asodfoyy",'o')) = {"as","df","yy"}
StringUtils.split("as.df.yy",'.')) = {"as","df","yy"}
StringUtils.split("as\ndf\nyy",'\n'))= {"as","df","yy"}
StringUtils.split("as",' ')) = {"as"}
StringUtils.split(" as ",' ')) = {"as"}

54.public static String[] split(String str, String separatorChars)
把字符串拆分成一个字符串数组，用指定的字符串separatorChars作为分隔符。
如果字符串str为null，返回null
如果字符串str为""，返回空数组{}
如果separatorChars为null，则默认为空白符
和53类似。
举例(*表示任意)：
StringUtils.split("as \rdf \t yy",null)) = {"as","df","yy"}
StringUtils.split("as\ndf\fyy",null)) = {"as","df","yy"}
StringUtils.split("as","")) = {"as"}

55.public static String[] split(String str, String separatorChars, int max)
把字符串拆分成一个字符串数组，用指定的字符串separatorChars作为分隔符，
数组的最大长度为max。
如果字符串str为null，返回null
如果字符串str为""，返回空数组{}
如果separatorChars为null，则默认为空白符
如果max小于等于0，认为是没有限制
举例(*表示任意)：
StringUtils.split(null, *, *) = null
StringUtils.split("", *, *) = {}
StringUtils.split("as df yy",null,0)) = {"as","df","yy"}
StringUtils.split("as df yy"," ",0)) = {"as","df","yy"}
StringUtils.split("as.df.yy",".",-1)) = {"as","df","yy"}
StringUtils.split("as.df.yy",".",4)) = {"as","df","yy"}
StringUtils.split("as-!-df-!-yy","-!-",0)) = {"as","df","yy"}
StringUtils.split("as.df.yy",".",2)) = {"as","df.yy"}
StringUtils.split("as","",0)) = {"as"}
StringUtils.split("as","",2)) = {"as"}

56.public static String[] splitByWholeSeparator(String str, String separator)
个人认为和54功能一样。区别有待发掘。

57.public static String[] splitByWholeSeparator( String str, String separator, int max )
个人认为和55功能一样。区别有待发掘。

58.public static String[] splitPreserveAllTokens(String str)
把字符串str拆分成一个数组，用空白符(whitespace)作为分隔符，保留所有的标识，
包括相邻分隔符产生的空的标识。它可作为StringTokenizer的一个替代。
Whitespace是这样定义的{@link Character#isWhitespace(char)}。
举例(*表示任意)：
StringUtils.splitPreserveAllTokens(null)) = null
StringUtils.splitPreserveAllTokens("")) = {}
StringUtils.splitPreserveAllTokens("as df gh jk")) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as\ndf\rgh\fjk")) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as\tdf gh jk")) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as df gh")) = {"as","","df","gh"}
StringUtils.splitPreserveAllTokens(" as df ")) = {"","as","","","df","",""}

59.public static String[] splitPreserveAllTokens(String str, char separatorChar)
和58类似，只是分隔符为字符separatorChar。
举例(*表示任意)：
StringUtils.splitPreserveAllTokens(null, *) = null
StringUtils.splitPreserveAllTokens("", *) = {}
StringUtils.splitPreserveAllTokens("as df gh jk",' ')) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as.df.gh.jk",'.')) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as..df.gh",'.')) = {"as","","df","gh"}
StringUtils.splitPreserveAllTokens(",as,,,df,,",',')) = {"","as","","","df","",""}
StringUtils.splitPreserveAllTokens("as.df.gh",',')) = {"as.df.gh"}

60.public static String[] splitPreserveAllTokens(String str, String separatorChars)
和59类似，只是分隔符为字符串separatorChars。
举例(*表示任意)：
StringUtils.splitPreserveAllTokens(null, *) = null
StringUtils.splitPreserveAllTokens("", *) = {}
StringUtils.splitPreserveAllTokens("as df gh jk",null)) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as\ndf\rgh\fjk",null))= {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as df gh jk"," ")) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as.df.gh.jk",".")) = {"as","df","gh","jk"}
StringUtils.splitPreserveAllTokens("as..df.gh",".")) = {"as","","df","gh"}
StringUtils.splitPreserveAllTokens(",as,,,df,,",",")) = {"","as","","","df","",""}
StringUtils.splitPreserveAllTokens("as.df.gh",",")) = {"as.df.gh"}
StringUtils.splitPreserveAllTokens("as.df.gh","")) = {"as.df.gh"}

61.public static String[] splitPreserveAllTokens(String str, String separatorChars, int max)
和上面几个类似，只是指定了数组的最大长度。
如果max为0或负数，则认为没有限制。
这里不再举例。

62.public static String join(Object[] array)
把数组中的元素连接成一个字符串返回。
举例(*表示任意)：
StringUtils.join(null) = null
StringUtils.join({}) = ""
StringUtils.join({"as","df","gh","jk"})) = "asdfghjk"
StringUtils.join({"as","","df","gh"})) = "asdfgh"
StringUtils.join({"","as","","","df","",""})) = "asdf"

63.public static String join(Object[] array, char separator)
把数组中的元素连接成一个字符串返回，把分隔符separator也加上。
举例(*表示任意)：
StringUtils.join(null, *) = null
StringUtils.join({}, *) = ""
StringUtils.join({null}, *) = ""
StringUtils.join({"as","df","gh","jk"},' ')) = "as df gh jk"
StringUtils.join({"as","df","gh","jk"},'.')) = "as.df.gh.jk"
StringUtils.join({"as","","df","gh"},'.')) = "as..df.gh"
StringUtils.join({"","as","","","df","",""},','))= ",as,,,df,,"
StringUtils.join({"","as","","","df","",""},' '))= " as df "
StringUtils.join({"as.df.gh"},'.')) = "as.df.gh"
StringUtils.join({"as.df.gh"},' ')) = "as.df.gh"

64.public static String join(Object[] array, char separator, int startIndex, int endIndex)
把数组中的元素连接成一个字符串返回，把分隔符separator也加上。
连接的开始位置为startIndex，结束位置为endIndex。
这里不再举例。

65.public static String join(Object[] array, String separator)
与63类似，这里不再举例。

66.public static String join(Object[] array, String separator, int startIndex, int endIndex)
与64类似，这里不再举例。