Apache StringUtils源码详解

Apache StringUtils源码详解

1、成员变量

• SPACE = " "，空白字符串
• EMPTY=""，空字符串
• LF="\n"，换行
• CR="\n"，回车
• int INDEX_NOT_FOUND=-1，字符串查找未找到时返回的值
• int PAD_LIMIT=8192

回车和换行的区别？

回车会回到本行的行首，换行才会到下一行行首

2、方法

2.1 isEmpty(final CharSequence cs)

public static boolean isEmpty(final CharSequence cs) {
        return cs == null || cs.length() == 0;
    }

该方法判断输入的字符序列是否为空，当字符序列为null或者长度为0时返回true，其他情况返回false。

需要注意的是空白字符序列不为空。

2.2 isNotEmpty(final CharSequence cs)

public static boolean isNotEmpty(final CharSequence cs) {
        return !isEmpty(cs);
    }

该方法判断输入的字符序列是否不为空，取值与isEmpty相反。

2.3 isAnyEmpty(final CharSequence... css)

public static boolean isAnyEmpty(final CharSequence... css) {
      if (ArrayUtils.isEmpty(css)) {
        return true;
      }
      for (final CharSequence cs : css){
        if (isEmpty(cs)) {
          return true;
        }
      }
      return false;
    }

该方法判断一个字符序列数组中是否有任意一个为空，是则返回true，否则返回false。

2.4 isNoneEmpty(final CharSequence... css)

public static boolean isNoneEmpty(final CharSequence... css) {
      return !isAnyEmpty(css);
    } 

判断字符序列数组是否都不为空。

2.5 isBlank(final CharSequence cs)

public static boolean isBlank(final CharSequence cs) {
        int strLen;
        if (cs == null || (strLen = cs.length()) == 0) {
            return true;
        }
        for (int i = 0; i < strLen; i++) {
            if (Character.isWhitespace(cs.charAt(i)) == false) {
                return false;
            }
        }
        return true;
    }

判断输入字符序列是否为空白，所谓的空白字符串包括三种情况

• 空串
• 只包含空白字符的串
• null

2.6 isNotBlank(final CharSequence cs)

public static boolean isNotBlank(final CharSequence cs) {
        return !isBlank(cs);
    }

判断输入字符序列是否非空白，返回值与2.5相反。

2.7 isAnyBlank(final CharSequence... css)

public static boolean isAnyBlank(final CharSequence... css) {
      if (ArrayUtils.isEmpty(css)) {
        return true;
      }
      for (final CharSequence cs : css){
        if (isBlank(cs)) {
          return true;
        }
      }
      return false;
    }

判断输入的字符序列数组是否有任意一个为空白。

2.8 isNoneBlank(final CharSequence... css)

public static boolean isNoneBlank(final CharSequence... css) {
      return !isAnyBlank(css);
    }

判断输入的字符序列数组是否都不为空白

2.9 trim(final String str)

public static String trim(final String str) {
        return str == null ? null : str.trim();
    }

移除输入字符序列的首尾空白字符。如果输入字符序列为null，则返回null。

2.10 trimToNull(final String str)

 public static String trimToNull(final String str) {
        final String ts = trim(str);
        return isEmpty(ts) ? null : ts;
    }

移除输入字符序列首尾空白字符，如果移除后的字符序列为空（""或者null），则返回null，否则返回移除后的字符串。

2.11 trimToEmpty(final String str)

public static String trimToEmpty(final String str) {
        return str == null ? EMPTY : str.trim();
    }

如果输入字符序列为null，则返回""，否则返回移除首尾空白字符的结果。

2.12 strip(final String str)

public static String strip(final String str) {
        return strip(str, null);
    }

其效果等同于trim。

2.13 stripToNull(String str)

public static String stripToNull(String str) {
        if (str == null) {
            return null;
        }
        str = strip(str, null);
        return str.isEmpty() ? null : str;
    }

其效果等同于trimToNull。

2.14 stripToEmpty(final String str)

public static String stripToEmpty(final String str) {
        return str == null ? EMPTY : strip(str, null);
    }

其效果等同于trimToEmpty。

2.15 String stripStart(final String str, final String stripChars)

移除str首部任何stripChars中的任意字符。stripChars=null时，视为""处理。

• StringUtils.stripStart(null, *) = null
• StringUtils.stripStart("", *) = ""
• StringUtils.stripStart("abc", "") = "abc"
• StringUtils.stripStart("abc", null) = "abc"
• StringUtils.stripStart(" abc", null) = "abc"
• StringUtils.stripStart("abc ", null) = "abc "
• StringUtils.stripStart(" abc ", null) = "abc "
• StringUtils.stripStart("yxabc ", "xyz") = "abc "

2.16 String stripEnd(final String str, final String stripChars)

作用跟2.15类似，只不过是从尾部移除。

• StringUtils.stripEnd(null, *) = null
• StringUtils.stripEnd("", *) = ""
• StringUtils.stripEnd("abc", "") = "abc"
• StringUtils.stripEnd("abc", null) = "abc"
• StringUtils.stripEnd(" abc", null) = " abc"
• StringUtils.stripEnd("abc ", null) = "abc"
• StringUtils.stripEnd(" abc ", null) = " abc"
• StringUtils.stripEnd(" abcyx", "xyz") = " abc"
• StringUtils.stripEnd("120.00", ".0") = "12"

2.17 stripAll(final String... strs)

String[] stripAll(final String... strs) {
        return stripAll(strs, null);
    }

对于数组中的每一个字符串调用strip(String)方法。