apache common Lang包StringUtils系列(四)

61 public static boolean containsAny(CharSequence cs, char... searchChars)
功能：检查字符串cs中是否包含字符集searchChars中的任何一个字符。
返回值：如果包含，返回true，如果不包含，返回false；
                如果输入参数为null，返回false；
如果字符集searchChars的长度为0，则返回false；
实例：
 StringUtils.containsAny(null, *) = false
 StringUtils.containsAny("", *)    = false
 StringUtils.containsAny(*, null)  = false
 StringUtils.containsAny(*, [])      = false
 StringUtils.containsAny("zzabyycdxx",['z','a']) = true
 StringUtils.containsAny("zzabyycdxx",['b','y']) = true
 StringUtils.containsAny("aba", ['z'])           = false
 
62 public static boolean containsAny(CharSequence cs, CharSequence searchChars)
功能：检查字符串cs中是否包含字符串searchChars中的任何一个字符。
返回值：如果输入参数为null，返回false；
实例： 
 StringUtils.containsAny(null, *)            = false
 StringUtils.containsAny("", *)              = false
 StringUtils.containsAny(*, null)            = false
 StringUtils.containsAny(*, "")              = false
 StringUtils.containsAny("zzabyycdxx", "za") = true
 StringUtils.containsAny("zzabyycdxx", "by") = true
 StringUtils.containsAny("aba","z")          = false

63 public static int indexOfAnyBut(CharSequence cs, char... searchChars)
功能：查找任何一个不被包含在字符集searchChars中的字符第一次出现cs中的位置。
实例： 
 StringUtils.indexOfAnyBut(null, *)                              = -1
 StringUtils.indexOfAnyBut("", *)                                = -1
 StringUtils.indexOfAnyBut(*, null)                              = -1
 StringUtils.indexOfAnyBut(*, [])                                = -1
 StringUtils.indexOfAnyBut("zzabyycdxx", new char[] {'z', 'a'} ) = 3
 StringUtils.indexOfAnyBut("aba", new char[] {'z'} )             = 0
 StringUtils.indexOfAnyBut("aba", new char[] {'a', 'b'} )        = -1

64 public static int indexOfAnyBut(CharSequence seq, CharSequence searchChars)
功能：查找不包含在字符串searchChars中的字符第一次出现seq中的位置。
实例： 
 StringUtils.indexOfAnyBut(null, *)            = -1
 StringUtils.indexOfAnyBut("", *)              = -1
 StringUtils.indexOfAnyBut(*, null)            = -1
 StringUtils.indexOfAnyBut(*, "")              = -1
 StringUtils.indexOfAnyBut("zzabyycdxx", "za") = 3
 StringUtils.indexOfAnyBut("zzabyycdxx", "")   = -1
 StringUtils.indexOfAnyBut("aba","ab")         = -1
 
65 public static boolean containsOnly(CharSequence cs, String validChars)
功能：检查字符串cs中的所有字符是否是有效字符串中字符。
参数：cs-被检查字符串；
            validChars-有效字符串；
实例：
 StringUtils.containsOnly(null, *)       = false
 StringUtils.containsOnly(*, null)       = false
 StringUtils.containsOnly("", *)         = true
 StringUtils.containsOnly("ab", "")      = false
 StringUtils.containsOnly("abab", "abc") = true
 StringUtils.containsOnly("ab1", "abc")  = false
 StringUtils.containsOnly("abz", "abc")  = false
 
66 public static boolean containsNone(CharSequence cs, String invalidChars)
功能：检查字符串cs中的所有字符是否都不是有效字符串invalidChars中的字符。
参数：cs-被检查字符串；
            invalidChars-有效字符串；
实例： 
 StringUtils.containsNone(null, *)       = true
 StringUtils.containsNone(*, null)       = true
 StringUtils.containsNone("", *)         = true
 StringUtils.containsNone("ab", "")      = true
 StringUtils.containsNone("abab", "xyz") = true
 StringUtils.containsNone("ab1", "xyz")  = true
 StringUtils.containsNone("abz", "xyz")  = false
 
67 public static int indexOfAny(CharSequence str, CharSequence... searchStrs)
功能：查找searchStrs中的字符串第一次出现在str中的索引号。未有匹配的字符串返回-1.
参数：str-被检查字符串，可以为null
            searchStrs-用于查找的字符串数组，可以为null。
实例：
 StringUtils.indexOfAny(null, *)                     = -1
 StringUtils.indexOfAny(*, null)                     = -1
 StringUtils.indexOfAny(*, [])                       = -1
 StringUtils.indexOfAny("zzabyycdxx", ["ab","cd"])   = 2
 StringUtils.indexOfAny("zzabyycdxx", ["cd","ab"])   = 2
 StringUtils.indexOfAny("zzabyycdxx", ["mn","op"])   = -1
 StringUtils.indexOfAny("zzabyycdxx", ["zab","aby"]) = 1
 StringUtils.indexOfAny("zzabyycdxx", [""])          = 0
 StringUtils.indexOfAny("", [""])                    = 0
 StringUtils.indexOfAny("", ["a"])                   = -1
 
68 public static int lastIndexOfAny(CharSequence str, CharSequence... searchStrs)
功能：查找searchStrs中的字符串最后一次出现在str中的索引号。
返回值：
（1）如果参数都为null，则返回-1；
（2）如果searchStrs为null，或者长度为零，则返回-1；
（3）如果searchStrs不为null，且包含“”字符串，在str不为null的情况下，返回str的长度。
实例：
 StringUtils.lastIndexOfAny(null, *)                   = -1
 StringUtils.lastIndexOfAny(*, null)                   = -1
 StringUtils.lastIndexOfAny(*, [])                     = -1
 StringUtils.lastIndexOfAny(*, [null])                 = -1
 StringUtils.lastIndexOfAny("zzabyycdxx", ["ab","cd"]) = 6
 StringUtils.lastIndexOfAny("zzabyycdxx", ["cd","ab"]) = 6
 StringUtils.lastIndexOfAny("zzabyycdxx", ["mn","op"]) = -1
 StringUtils.lastIndexOfAny("zzabyycdxx", ["mn","op"]) = -1
 StringUtils.lastIndexOfAny("zzabyycdxx", ["mn",""])   = 10
 
69 public static String substring(String str, int start)
功能：返回字符串str的子串。
返回值：
（1）如果start为非负数，则返回以start为开始索引号的子串。
（2）如果start为负数，则返回从str末尾往前数长度为|start|的子串。
实例：
 StringUtils.substring(null, *)   = null
 StringUtils.substring("", *)     = ""
 StringUtils.substring("abc", 0)  = "abc"
 StringUtils.substring("abc", 2)  = "c"
 StringUtils.substring("abc", 4)  = ""
 StringUtils.substring("abc", -2) = "bc"
 StringUtils.substring("abc", -4) = "abc"
 
70 public static String substring(String str, int start, int end)
功能：返回从str字符串的start位置开始到end位置前一字符结束的子串。
返回值：
（1）如果start和end为负数，则start/end位置确定为从str末尾开始往前数的第|start|/|end|个字符的位置。
（2）如果end-start为负数，则返回“”；
（3）如果start和end为正，代表的是str中字符的索引位置。
实例：
 StringUtils.substring(null, *, *)    = null
 StringUtils.substring("", * ,  *)    = "";
 StringUtils.substring("abc", 0, 2)   = "ab"
 StringUtils.substring("abc", 2, 0)   = ""
 StringUtils.substring("abc", 2, 4)   = "c"
 StringUtils.substring("abc", 4, 6)   = ""
 StringUtils.substring("abc", 2, 2)   = ""
 StringUtils.substring("abc", -2, -1) = "b"
 StringUtils.substring("abc", -4, 2)  = "ab"
 
71 public static String left(String str, int len)
功能：获取str中最左边长度为len的子串。
返回值：
（1）如果len为负数，返回“”
（2）如果str为null，返回null；
（3）如果str为“”，返回“”；
实例：
 StringUtils.left(null, *)    = null
 StringUtils.left(*, -ve)     = ""
 StringUtils.left("", *)      = ""
 StringUtils.left("abc", 0)   = ""
 StringUtils.left("abc", 2)   = "ab"
 StringUtils.left("abc", 4)   = "abc"

72 public static String right(String str,int len)
功能：获取str中最后边长度为len的子串。
返回值：
（1）如果len为负数，返回“”
（2）如果str为null，返回null；
（3）如果str为“”，返回“”；
实例：
 StringUtils.right(null, *)    = null
 StringUtils.right(*, -ve)     = ""
 StringUtils.right("", *)      = ""
 StringUtils.right("abc", 0)   = ""
 StringUtils.right("abc", 2)   = "bc"
 StringUtils.right("abc", 4)   = "abc"
 
73 public static String mid(String str, int pos, int len)
功能：返回str中，从pos位置开始，长度为len的子串。
参数：
 str-源字符串，可以为null；
 pos-开始位置，如果为负数，则被视为开始位置为0；
 len-子串长度
实例：
 StringUtils.mid(null, *, *)    = null
 StringUtils.mid(*, *, -ve)     = ""
 StringUtils.mid("", 0, *)      = ""
 StringUtils.mid("abc", 0, 2)   = "ab"
 StringUtils.mid("abc", 0, 4)   = "abc"
 StringUtils.mid("abc", 2, 4)   = "c"
 StringUtils.mid("abc", 4, 2)   = ""
 StringUtils.mid("abc", -2, 2)  = "ab"
 
74 public static String substringBefore(String str,String separator)
功能：获取字符串separator第一次出现在字符串str中之前的子串。
返回值：
（1）输入参数为“”时，返回“”；
（2）输入str为null时，返回null；
（3）输入separator为null时，如果str不为null，返回str字符串；
（4）在str中如果没有查找到separator，则返回“”；
实例：
 StringUtils.substringAfter(null, *)      = null
 StringUtils.substringAfter("", *)        = ""
 StringUtils.substringAfter(*, null)      = ""
 StringUtils.substringAfter("abc", "a")   = "bc"
 StringUtils.substringAfter("abcba", "b") = "cba"
 StringUtils.substringAfter("abc", "c")   = ""
 StringUtils.substringAfter("abc", "d")   = ""
 StringUtils.substringAfter("abc", "")    = "abc"
 
75 public static String substringBeforeLast(String str,String separator)
功能：获取字符串separator最后一次出现在字符串str中之前的子串。
返回值：
（1）输入str为“”时，返回“”；
（2）输入str为null时，返回null；
（3）输入separator为null或“”时，返回str字符串；
（4）在str中如果没有查找到separator，则返回str字符串；
实例：
 StringUtils.substringBeforeLast(null, *)      = null
 StringUtils.substringBeforeLast("", *)        = ""
 StringUtils.substringBeforeLast("abcba", "b") = "abc"
 StringUtils.substringBeforeLast("abc", "c")   = "ab"
 StringUtils.substringBeforeLast("a", "a")     = ""
 StringUtils.substringBeforeLast("a", "z")     = "a"
 StringUtils.substringBeforeLast("a", null)    = "a"
 StringUtils.substringBeforeLast("a", "")      = "a"
 
76 public static String substringAfterLast(String str, String separator)
功能：获取字符串separator最后一次出现在字符串str中之后的子串。
返回值：
（1）输入str为“”时，返回“”；
（2）输入str为null时，返回null；
（3）输入separator为null或“”时，如果str不为null，返回“”字符串；
（4）在str中如果没有查找到separator，则返回“”字符串；
实例：
 StringUtils.substringAfterLast(null, *)      = null
 StringUtils.substringAfterLast("", *)        = ""
 StringUtils.substringAfterLast(*, "")        = ""
 StringUtils.substringAfterLast(*, null)      = ""
 StringUtils.substringAfterLast("abc", "a")   = "bc"
 StringUtils.substringAfterLast("abcba", "b") = "a"
 StringUtils.substringAfterLast("abc", "c")   = ""
 StringUtils.substringAfterLast("a", "a")     = ""
 StringUtils.substringAfterLast("a", "z")     = ""
 
77 public static String substringBetween(String str,String tag)
功能：获取在字符串str中嵌套在两个相同子串中的子串。
返回值：
（1）如果str或tag为null，则返回null；
（2）如果没有匹配的，返回null；
实例：
 StringUtils.substringBetween(null, *)            = null
 StringUtils.substringBetween("", "")             = ""
 StringUtils.substringBetween("", "tag")          = null
 StringUtils.substringBetween("tagabctag", null)  = null
 StringUtils.substringBetween("tagabctag", "")    = ""
 StringUtils.substringBetween("tagabctag", "tag") = "abc"
 
78 public static String substringBetween(String str,String open,String close)
功能：获取嵌套到字符串open和字符串close之间的子串。仅返回第一次匹配的结果。
返回值：
（1）如果str为null，则返回null；
（2）如果open或close其中一个为null，则返回null；
（3）如果open或close都为“”，则返回“”
实例：
 StringUtils.substringBetween("wx[b]yz", "[", "]") = "b"
 StringUtils.substringBetween(null, *, *)          = null
 StringUtils.substringBetween(*, null, *)          = null
 StringUtils.substringBetween(*, *, null)          = null
 StringUtils.substringBetween("", "", "")          = ""
 StringUtils.substringBetween("", "", "]")         = null
 StringUtils.substringBetween("", "[", "]")        = null
 StringUtils.substringBetween("yabcz", "", "")     = ""
 StringUtils.substringBetween("yabcz", "y", "z")   = "abc"
 StringUtils.substringBetween("yabczyabcz", "y", "z")   = "abc"
 
79 public static String[] substringsBetween(String str,String open,String close)
功能：查找在字符串open和字符串close之间的字符串，返回包含所有匹配子串的字符串数组。
返回值：
（1）如果str为null，则返回null；
（2）如果open或close其中一个为null，则返回null；
（3）如果open或close都为“”，则返回null。
实例：
 StringUtils.substringsBetween("[a][b][c]", "[", "]") = ["a","b","c"]
 StringUtils.substringsBetween(null, *, *)            = null
 StringUtils.substringsBetween(*, null, *)            = null
 StringUtils.substringsBetween(*, *, null)            = null
 StringUtils.substringsBetween("", "[", "]")          = []
 
80 public static String[] split(String str)
功能：使用空白符，分裂提供的文本字符串str。
注意：
（1）注意区别此处的空白符和空格符；
（2）空白符不包含在返回的字符串数组中；
（3）相邻的分隔符视为一个分割符；
（4）如果str为null，则返回null；
实例：
 StringUtils.split(null)       = null
 StringUtils.split("")         = []
 StringUtils.split("abc def")  = ["abc", "def"]
 StringUtils.split("abc  def") = ["abc", "def"]
 StringUtils.split(" abc ")    = ["abc"]