apache common Lang包StringUtils系列(三)

41 public static boolean equalsIgnoreCase(CharSequence str1,CharSequence str2)
同上，比较不区分大小写。
实例：
  StringUtils.equals(null, null)   = true
  StringUtils.equals(null, "abc")  = false
  StringUtils.equals("abc", null)  = false
  StringUtils.equals("abc", "abc") = true
  StringUtils.equals("abc", "ABC") = true
  
42 public static int indexOf(CharSequence seq, int searchChar)
功能：
  返回searchChar第一次在seq中出现的位置。如果，seq中没有出现searchChar，则返回-1；如果seq是""或null，则返回-1
实例：
  StringUtils.indexOf(null, *)         = -1
  StringUtils.indexOf("", *)           = -1
  StringUtils.indexOf("aabaabaa", 'a') = 0
  StringUtils.indexOf("aabaabaa", 'b') = 2

43 public static int indexOf(CharSequence seq, int searchChar, int startPos)
同上，从startPos开始查找，返回searchChar第一次在seq中出现的位置。
实例：
  StringUtils.indexOf(null, *, *)          = -1
  StringUtils.indexOf("", *, *)            = -1
  StringUtils.indexOf("aabaabaa", 'b', 0)  = 2
  StringUtils.indexOf("aabaabaa", 'b', 3)  = 5
  StringUtils.indexOf("aabaabaa", 'b', 9)  = -1
  StringUtils.indexOf("aabaabaa", 'b', -1) = 2

44 public static int indexOf(CharSequence seq,CharSequence searchSeq)
功能：返回searchSeq第一次在seq中出现的位置。如果任何一个参数为null，则返回-1；没有匹配的位置，则返回-1.
实例：
  StringUtils.indexOf(null, *)          = -1
  StringUtils.indexOf(*, null)          = -1
  StringUtils.indexOf("", "")           = 0
  StringUtils.indexOf("", *)            = -1 (except when * = "")
  StringUtils.indexOf("aabaabaa", "a")  = 0
  StringUtils.indexOf("aabaabaa", "b")  = 2
  StringUtils.indexOf("aabaabaa", "ab") = 1
  StringUtils.indexOf("aabaabaa", "")   = 0
练习：
  StringUtils.indexOf("aabaabaa", "")  = 0
  
45 public static int indexOf(CharSequence seq, CharSequence searchSeq, int startPos)
功能：从startPos开始查找，返回searchSeq第一次在seq中出现的位置。
      如果任何一个参数为null，则返回-1；没有匹配的位置，则返回-1.
 如果startPos为负数，则视为0；
 如果searchSeq为"",视为总能匹配；
 如果startPos大于seq的长度，只有当searchSeq为""时能匹配。
实例：
  StringUtils.indexOf(null, *, *)          = -1
  StringUtils.indexOf(*, null, *)          = -1
  StringUtils.indexOf("", "", 0)           = 0
  StringUtils.indexOf("", *, 0)            = -1 (except when * = "")
  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
  
46 public static int ordinalIndexOf(CharSequence str, CharSequence searchStr, int ordinal)
功能：返回字符串searchStr在字符串str中第ordinal次出现的位置。如果输入字符串为null或没有匹配的，返回-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", "", 1)   = 0

  StringUtils.ordinalIndexOf("aabaabaa", "", 2)   = 0

47 public static int indexOfIgnoreCase(CharSequence str, CharSequence searchStr)
功能：返回searchStr第一次在str中出现的位置。如果任何一个参数为null，则返回-1；没有匹配的位置，则返回-1.
实例：
 StringUtils.indexOfIgnoreCase(null, *)          = -1
 StringUtils.indexOfIgnoreCase(*, null)          = -1
 StringUtils.indexOfIgnoreCase("", "")           = 0
 StringUtils.indexOfIgnoreCase("aabaabaa", "a")  = 0
 StringUtils.indexOfIgnoreCase("aabaabaa", "Ab")  = 1
 StringUtils.indexOfIgnoreCase("aabaabaa", "ab") = 1
 
48 public static int indexOfIgnoreCase(CharSequence str, CharSequence searchStr, int startPos)
功能：从startPos开始查找，返回searchStr第一次出现在str中的位置。不区分大小写。
      如果str和searchStr为null，则返回-1；
 如果startPos为负数，则将startPos视为0；
 如果startPos大于str的长度，则只有searchStr为“”能匹配，否则返回-1.
实例：
 StringUtils.indexOfIgnoreCase(null, *, *)          = -1
 StringUtils.indexOfIgnoreCase(*, null, *)          = -1
 StringUtils.indexOfIgnoreCase("", "", 0)           = 0
 StringUtils.indexOfIgnoreCase("aabaabaa", "A", 0)  = 0
 StringUtils.indexOfIgnoreCase("aabaabaa", "B", 0)  = 2
 StringUtils.indexOfIgnoreCase("aabaabaa", "AB", 0) = 1
 StringUtils.indexOfIgnoreCase("aabaabaa", "B", 3)  = 5
 StringUtils.indexOfIgnoreCase("aabaabaa", "B", 9)  = -1
 StringUtils.indexOfIgnoreCase("aabaabaa", "B", -1) = 2
 StringUtils.indexOfIgnoreCase("aabaabaa", "", 2)   = 2
 StringUtils.indexOfIgnoreCase("abc", "", 9)        = 3
 
49 public static int lastIndexOf(CharSequence seq, int searchChar)
功能：从后往前查找，返回字符searchChar第一次出现在字符串seq中的位置。
      如果seq为null或“”，返回-1；
 没有匹配的，返回-1；
 区分大小写。
参数：seq-被检查的字符串，可以为null
      searchChar-用于寻到的字符。
实例：StringUtils.lastIndexOf(null, *)         = -1
      StringUtils.lastIndexOf("", *)           = -1
      StringUtils.lastIndexOf("aabaabaa", 'a') = 7
      StringUtils.lastIndexOf("aabaabaa", 'b') = 5

50 public static int lastIndexOf(CharSequence seq, int searchChar, int startPos)
功能：按照从后往前查找的顺序，从startPos位置开始查找，返回字符searchChar第一次出现在字符串seq中的位置。
参数：seq-被检查的字符串，可以为null
      searchChar-用于寻到的字符。
 startPos-开始查找的位置。（注：该函数是从后往前查找的）
返回值：如果没有匹配的，返回-1；
       如果seq为null或“”，返回-1；
  如果startPos大于字符串seq的长度，则搜索整个字符串；
实例： 
 StringUtils.lastIndexOf(null, *, *)          = -1
 StringUtils.lastIndexOf("", *,  *)           = -1
 StringUtils.lastIndexOf("aabaabaa", 'b', 8)  = 5
 StringUtils.lastIndexOf("aabaabaa", 'b', 4)  = 2
 StringUtils.lastIndexOf("aabaabaa", 'b', 0)  = -1
 StringUtils.lastIndexOf("aabaabaa", 'b', 9)  = 5
 StringUtils.lastIndexOf("aabaabaa", 'b', -1) = -1
 StringUtils.lastIndexOf("aabaabaa", 'a', 0)  = 0
 
51 public static int lastIndexOf(CharSequence seq, CharSequence searchSeq)
功能：从后往前查找，返回字符串第一次出现在字符串seq中的位置。
      如果没有匹配的，返回-1；
 如果seq或searchSeq为null，则返回-1；
参数：seq-被检查的字符串，可以为null；
      searchSeq-用于寻找的字符串，可以为null；
实例： 
 StringUtils.lastIndexOf(null, *)          = -1
 StringUtils.lastIndexOf(*, null)          = -1
 StringUtils.lastIndexOf("", "")           = 0
 StringUtils.lastIndexOf("aabaabaa", "a")  = 7
 StringUtils.lastIndexOf("aabaabaa", "b")  = 5
 StringUtils.lastIndexOf("aabaabaa", "ab") = 4
 StringUtils.lastIndexOf("aabaabaa", "")   = 8
 
52 public static int lastIndexOfIgnoreCase(CharSequence str, CharSequence searchStr)
功能：同上，从后往前查找，返回字符串searcheStr第一出现在str中的位置。不区分大小写。
实例： 
 StringUtils.lastIndexOfIgnoreCase(null, *)          = -1
 StringUtils.lastIndexOfIgnoreCase(*, null)          = -1
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "A")  = 7
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "B")  = 5
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "AB") = 4
 
53 public static int lastOrdinalIndexOf(CharSequence str, CharSequence searchStr, int ordinal)
功能：从后往前查找，返回字符串searchStr第ordinal次出现在str中的位置。
      如果输入字符串（str和searchStr）为null，则返回-1；
 如果没有匹配的，返回-1；
参数：str-被检查的字符串，可以为null；
      searchStr-用于寻找的字符串，可以为null；
 ordinal-定位次数。
实例： 
 StringUtils.lastOrdinalIndexOf(null, *, *)          = -1
 StringUtils.lastOrdinalIndexOf(*, null, *)          = -1
 StringUtils.lastOrdinalIndexOf("", "", *)           = 0
 StringUtils.lastOrdinalIndexOf("aabaabaa", "a", 1)  = 7
 StringUtils.lastOrdinalIndexOf("aabaabaa", "a", 2)  = 6
 StringUtils.lastOrdinalIndexOf("aabaabaa", "b", 1)  = 5
 StringUtils.lastOrdinalIndexOf("aabaabaa", "b", 2)  = 2
 StringUtils.lastOrdinalIndexOf("aabaabaa", "ab", 1) = 4
 StringUtils.lastOrdinalIndexOf("aabaabaa", "ab", 2) = 1
 StringUtils.lastOrdinalIndexOf("aabaabaa", "", 1)   = 8
 StringUtils.lastOrdinalIndexOf("aabaabaa", "", 2)   = 8
 
54 public static int lastIndexOf(CharSequence seq, CharSequence searchSeq, int startPos)
功能：按照从后往前的顺序，在字符串seq中，从startPos位置开始查找字符串searchSeq第一次出现的位置。
返回值：
    如果输入字符串（seq和searchSeq）为null，则返回-1；
如果startPos为负数，则返回-1；
如果startPos大于seq的长度，则查找整个字符串；
实例： 
 StringUtils.lastIndexOf(null, *, *)          = -1
 StringUtils.lastIndexOf("aabaabaa", "a", 8)  = 7
 StringUtils.lastIndexOf("aabaabaa", "ab", 8) = 4
 StringUtils.lastIndexOf("aabaabaa", "b", 9)  = 5
 StringUtils.lastIndexOf("aabaabaa", "b", -1) = -1
 StringUtils.lastIndexOf("aabaabaa", "a", 0)  = 0
 StringUtils.lastIndexOf("aabaabaa", "b", 1)  = -1
 StringUtils.lastIndexOf("aabaabaa", "b", 2)  = 2
 StringUtils.lastIndexOf("aabaabaa", "ba", 2)  = -1
 StringUtils.lastIndexOf("aabaabaa", "ba", 2)  = 2
 
55 public static int lastIndexOfIgnoreCase(CharSequence str, CharSequence searchStr, int startPos)
功能：同上，查找不区分大小写。
实例： 
 StringUtils.lastIndexOfIgnoreCase(null, *, *)          = -1
 StringUtils.lastIndexOfIgnoreCase(*, null, *)          = -1
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "A", 8)  = 7
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "B", 8)  = 5
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "AB", 8) = 4
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "B", 9)  = 5
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "B", -1) = -1
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "A", 0)  = 0
 StringUtils.lastIndexOfIgnoreCase("aabaabaa", "B", 0)  = -1

56 public static boolean contains(CharSequence seq, int searchChar)
功能：查找字符串seq中是否包含了字符searchChar。
返回值：如果包含则返回true，不包含则返回false；
        如果seq为null或“”，返回false；
实例：
 StringUtils.contains(null, *)    = false
 StringUtils.contains("", *)      = false
 StringUtils.contains("abc", 'a') = true
 StringUtils.contains("abc", 'z') = false
 
57 public static boolean contains(CharSequence seq, CharSequence searchSeq)
功能：查找字符串seq中是否包含了字符串searchSeq。
返回：如果包含则返回true，不包含则返回false；
      如果输入字符串（seq和searchSeq）为null，返回false；
实例： 
 StringUtils.contains(null, *)     = false
 StringUtils.contains(*, null)     = false
 StringUtils.contains("", "")      = true
 StringUtils.contains("abc", "")   = true
 StringUtils.contains("abc", "a")  = true
 StringUtils.contains("abc", "z")  = false
 
58 public static boolean containsIgnoreCase(CharSequence str, CharSequence searchStr)
功能：同上，查找不区分大小写。
实例：
 StringUtils.contains(null, *) = false
 StringUtils.contains(*, null) = false
 StringUtils.contains("", "") = true
 StringUtils.contains("abc", "") = true
 StringUtils.contains("abc", "a") = true
 StringUtils.contains("abc", "z") = false
 StringUtils.contains("abc", "A") = true
 StringUtils.contains("abc", "Z") = false
 
59 public static int indexOfAny(CharSequence cs, char... searchChars)
功能：返回searchChars中字符第一次出现在cs中的位置。
返回值：如果cs为null，返回-1；
        如果searchChars数组为null或长度为0，返回-1；
没有匹配的，返回-1；
实例： 
 StringUtils.indexOfAny(null, *)                = -1
 StringUtils.indexOfAny("", *)                  = -1
 StringUtils.indexOfAny(*, null)                = -1
 StringUtils.indexOfAny(*, [])                  = -1
 StringUtils.indexOfAny("zzabyycdxx",['z','a']) = 0
 StringUtils.indexOfAny("zzabyycdxx",['b','y']) = 3
 StringUtils.indexOfAny("aba", ['z'])           = -1
 
60 public static int indexOfAny(CharSequence cs, String searchChars)
功能：返回字符串中任何字符第一次出现在字符串cs中的位置。
返回值：输入字符串为null，返回-1；
        没有匹配的，返回-1；
实例： 
 StringUtils.indexOfAny(null, *)            = -1
 StringUtils.indexOfAny("", *)              = -1
 StringUtils.indexOfAny(*, null)            = -1
 StringUtils.indexOfAny(*, "")              = -1
 StringUtils.indexOfAny("zzabyycdxx", "za") = 0
 StringUtils.indexOfAny("zzabyycdxx", "by") = 3
 StringUtils.indexOfAny("aba","z")          = -1