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)方法。
