本文共 103326 字，大约阅读时间需要 344 分钟。
StringUtils中方法的操作对象是java.lang.String类型的对象，是JDK提供的String类型操作方法的补充，并且是null安全的(即如果输入参数String为null则不会抛出NullPointerException，而是做了相应处理，例如，如果输入为null则返回也是null等，具体可以查看源代码)。
StringUtils的源码：
package cn.hutool.core.util;import cn.hutool.core.comparator.VersionComparator;import cn.hutool.core.convert.Convert;import cn.hutool.core.lang.Assert;import cn.hutool.core.lang.Matcher;import cn.hutool.core.lang.func.Func1;import cn.hutool.core.text.StrBuilder;import cn.hutool.core.text.StrFormatter;import cn.hutool.core.text.StrSpliter;import cn.hutool.core.text.TextSimilarity;import java.io.StringReader;import java.io.StringWriter;import java.nio.ByteBuffer;import java.nio.charset.Charset;import java.text.MessageFormat;import java.util.ArrayList;import java.util.HashSet;import java.util.LinkedList;import java.util.List;import java.util.Map;import java.util.Map.Entry;import java.util.Set;import java.util.regex.Pattern;/** * 字符串工具类 * * @author xiaoleilu */public class StrUtil { public static final int INDEX_NOT_FOUND = -1; public static final char C_SPACE = CharUtil.SPACE; public static final char C_TAB = CharUtil.TAB; public static final char C_DOT = CharUtil.DOT; public static final char C_SLASH = CharUtil.SLASH; public static final char C_BACKSLASH = CharUtil.BACKSLASH; public static final char C_CR = CharUtil.CR; public static final char C_LF = CharUtil.LF; public static final char C_UNDERLINE = CharUtil.UNDERLINE; public static final char C_COMMA = CharUtil.COMMA; public static final char C_DELIM_START = CharUtil.DELIM_START; public static final char C_DELIM_END = CharUtil.DELIM_END; public static final char C_BRACKET_START = CharUtil.BRACKET_START; public static final char C_BRACKET_END = CharUtil.BRACKET_END; public static final char C_COLON = CharUtil.COLON; public static final String SPACE = " "; public static final String TAB = " "; public static final String DOT = "."; public static final String DOUBLE_DOT = ".."; public static final String SLASH = "/"; public static final String BACKSLASH = "\\"; public static final String EMPTY = ""; public static final String NULL = "null"; public static final String CR = "\r"; public static final String LF = "\n"; public static final String CRLF = "\r\n"; public static final String UNDERLINE = "_"; public static final String DASHED = "-"; public static final String COMMA = ","; public static final String DELIM_START = "{"; public static final String DELIM_END = "}"; public static final String BRACKET_START = "["; public static final String BRACKET_END = "]"; public static final String COLON = ":"; public static final String HTML_NBSP = " "; public static final String HTML_AMP = "&"; public static final String HTML_QUOTE = """; public static final String HTML_APOS = "'"; public static final String HTML_LT = "<"; public static final String HTML_GT = ">"; public static final String EMPTY_JSON = "{}"; // ------------------------------------------------------------------------ Blank /** * 字符串是否为空白 空白的定义如下： <br> * 1、为null <br> * 2、为不可见字符（如空格）<br> * 3、""<br> * * @param str 被检测的字符串 * @return 是否为空 */ public static boolean isBlank(CharSequence str) { int length; if ((str == null) || ((length = str.length()) == 0)) { return true; } for (int i = 0; i < length; i++) { // 只要有一个非空字符即为非空字符串 if (false == CharUtil.isBlankChar(str.charAt(i))) { return false; } } return true; } /** * 如果对象是字符串是否为空白，空白的定义如下： <br> * 1、为null <br> * 2、为不可见字符（如空格）<br> * 3、""<br> * * @param obj 对象 * @return 如果为字符串是否为空串 * @since 3.3.0 */ public static boolean isBlankIfStr(Object obj) { if (null == obj) { return true; } else if (obj instanceof CharSequence) { return isBlank((CharSequence) obj); } return false; } /** * 字符串是否为非空白 空白的定义如下： <br> * 1、不为null <br> * 2、不为不可见字符（如空格）<br> * 3、不为""<br> * * @param str 被检测的字符串 * @return 是否为非空 */ public static boolean isNotBlank(CharSequence str) { return false == isBlank(str); } /** * 是否包含空字符串 * * @param strs 字符串列表 * @return 是否包含空字符串 */ public static boolean hasBlank(CharSequence... strs) { if (ArrayUtil.isEmpty(strs)) { return true; } for (CharSequence str : strs) { if (isBlank(str)) { return true; } } return false; } /** * 给定所有字符串是否为空白 * * @param strs 字符串 * @return 所有字符串是否为空白 */ public static boolean isAllBlank(CharSequence... strs) { if (ArrayUtil.isEmpty(strs)) { return true; } for (CharSequence str : strs) { if (isNotBlank(str)) { return false; } } return true; } // ------------------------------------------------------------------------ Empty /** * 字符串是否为空，空的定义如下:<br> * 1、为null <br> * 2、为""<br> * * @param str 被检测的字符串 * @return 是否为空 */ public static boolean isEmpty(CharSequence str) { return str == null || str.length() == 0; } /** * 如果对象是字符串是否为空串空的定义如下:<br> * 1、为null <br> * 2、为""<br> * * @param obj 对象 * @return 如果为字符串是否为空串 * @since 3.3.0 */ public static boolean isEmptyIfStr(Object obj) { if (null == obj) { return true; } else if (obj instanceof CharSequence) { return 0 == ((CharSequence) obj).length(); } return false; } /** * 字符串是否为非空白 空白的定义如下： <br> * 1、不为null <br> * 2、不为""<br> * * @param str 被检测的字符串 * @return 是否为非空 */ public static boolean isNotEmpty(CharSequence str) { return false == isEmpty(str); } /** * 当给定字符串为null时，转换为Empty * * @param str 被检查的字符串 * @return 原字符串或者空串 * @see #nullToEmpty(CharSequence) * @since 4.6.3 */ public static String emptyIfNull(CharSequence str) { return nullToEmpty(str); } /** * 当给定字符串为null时，转换为Empty * * @param str 被转换的字符串 * @return 转换后的字符串 */ public static String nullToEmpty(CharSequence str) { return nullToDefault(str, EMPTY); } /** * 如果字符串是<code>null</code>，则返回指定默认字符串，否则返回字符串本身。 * * <pre> * nullToDefault(null, "default") = "default" * nullToDefault("", "default") = "" * nullToDefault(" ", "default") = " " * nullToDefault("bat", "default") = "bat" * </pre> * * @param str 要转换的字符串 * @param defaultStr 默认字符串 * @return 字符串本身或指定的默认字符串 */ public static String nullToDefault(CharSequence str, String defaultStr) { return (str == null) ? defaultStr : str.toString(); } /** * 如果字符串是<code>null</code>或者""，则返回指定默认字符串，否则返回字符串本身。 * * <pre> * emptyToDefault(null, "default") = "default" * emptyToDefault("", "default") = "default" * emptyToDefault(" ", "default") = " " * emptyToDefault("bat", "default") = "bat" * </pre> * * @param str 要转换的字符串 * @param defaultStr 默认字符串 * @return 字符串本身或指定的默认字符串 * @since 4.1.0 */ public static String emptyToDefault(CharSequence str, String defaultStr) { return isEmpty(str) ? defaultStr : str.toString(); } /** * 如果字符串是<code>null</code>或者""或者空白，则返回指定默认字符串，否则返回字符串本身。 * * <pre> * emptyToDefault(null, "default") = "default" * emptyToDefault("", "default") = "default" * emptyToDefault(" ", "default") = "default" * emptyToDefault("bat", "default") = "bat" * </pre> * * @param str 要转换的字符串 * @param defaultStr 默认字符串 * @return 字符串本身或指定的默认字符串 * @since 4.1.0 */ public static String blankToDefault(CharSequence str, String defaultStr) { return isBlank(str) ? defaultStr : str.toString(); } /** * 当给定字符串为空字符串时，转换为<code>null</code> * * @param str 被转换的字符串 * @return 转换后的字符串 */ public static String emptyToNull(CharSequence str) { return isEmpty(str) ? null : str.toString(); } /** * 是否包含空字符串 * * @param strs 字符串列表 * @return 是否包含空字符串 */ public static boolean hasEmpty(CharSequence... strs) { if (ArrayUtil.isEmpty(strs)) { return true; } for (CharSequence str : strs) { if (isEmpty(str)) { return true; } } return false; } /** * 是否全部为空字符串 * * @param strs 字符串列表 * @return 是否全部为空字符串 */ public static boolean isAllEmpty(CharSequence... strs) { if (ArrayUtil.isEmpty(strs)) { return true; } for (CharSequence str : strs) { if (isNotEmpty(str)) { return false; } } return true; } /** * 检查字符串是否为null、“null”、“undefined” * * @param str 被检查的字符串 * @return 是否为null、“null”、“undefined” * @since 4.0.10 */ public static boolean isNullOrUndefined(CharSequence str) { if (null == str) { return true; } return isNullOrUndefinedStr(str); } /** * 检查字符串是否为null、“”、“null”、“undefined” * * @param str 被检查的字符串 * @return 是否为null、“”、“null”、“undefined” * @since 4.0.10 */ public static boolean isEmptyOrUndefined(CharSequence str) { if (isEmpty(str)) { return true; } return isNullOrUndefinedStr(str); } /** * 检查字符串是否为null、空白串、“null”、“undefined” * * @param str 被检查的字符串 * @return 是否为null、空白串、“null”、“undefined” * @since 4.0.10 */ public static boolean isBlankOrUndefined(CharSequence str) { if (isBlank(str)) { return true; } return isNullOrUndefinedStr(str); } /** * 是否为“null”、“undefined”，不做空指针检查 * * @param str 字符串 * @return 是否为“null”、“undefined” */ private static boolean isNullOrUndefinedStr(CharSequence str) { String strString = str.toString().trim(); return NULL.equals(strString) || "undefined".equals(strString); } // ------------------------------------------------------------------------ Trim /** * 除去字符串头尾部的空白，如果字符串是<code>null</code>，依然返回<code>null</code>。 * * <p> * 注意，和<code>String.trim</code>不同，此方法使用<code>NumberUtil.isBlankChar</code> 来判定空白， 因而可以除去英文字符集之外的其它空白，如中文空格。 * * <pre> * trim(null) = null * trim("") = "" * trim(" ") = "" * trim("abc") = "abc" * trim(" abc ") = "abc" * </pre> * * @param str 要处理的字符串 * @return 除去头尾空白的字符串，如果原字串为<code>null</code>，则返回<code>null</code> */ public static String trim(CharSequence str) { return (null == str) ? null : trim(str, 0); } /** * 给定字符串数组全部做去首尾空格 * * @param strs 字符串数组 */ public static void trim(String[] strs) { if (null == strs) { return; } String str; for (int i = 0; i < strs.length; i++) { str = strs[i]; if (null != str) { strs[i] = str.trim(); } } } /** * 除去字符串头尾部的空白，如果字符串是{@code null}，返回<code>""</code>。 * * <pre> * StrUtil.trimToEmpty(null) = "" * StrUtil.trimToEmpty("") = "" * StrUtil.trimToEmpty(" ") = "" * StrUtil.trimToEmpty("abc") = "abc" * StrUtil.trimToEmpty(" abc ") = "abc" * </pre> * * @param str 字符串 * @return 去除两边空白符后的字符串, 如果为null返回"" * @since 3.1.1 */ public static String trimToEmpty(CharSequence str) { return str == null ? EMPTY : trim(str); } /** * 除去字符串头尾部的空白，如果字符串是{@code null}，返回<code>""</code>。 * * <pre> * StrUtil.trimToNull(null) = null * StrUtil.trimToNull("") = null * StrUtil.trimToNull(" ") = null * StrUtil.trimToNull("abc") = "abc" * StrUtil.trimToEmpty(" abc ") = "abc" * </pre> * * @param str 字符串 * @return 去除两边空白符后的字符串, 如果为空返回null * @since 3.2.1 */ public static String trimToNull(CharSequence str) { final String trimStr = trim(str); return EMPTY.equals(trimStr) ? null : trimStr; } /** * 除去字符串头部的空白，如果字符串是<code>null</code>，则返回<code>null</code>。 * * <p> * 注意，和<code>String.trim</code>不同，此方法使用<code>CharUtil.isBlankChar</code> 来判定空白， 因而可以除去英文字符集之外的其它空白，如中文空格。 * * <pre> * trimStart(null) = null * trimStart("") = "" * trimStart("abc") = "abc" * trimStart(" abc") = "abc" * trimStart("abc ") = "abc " * trimStart(" abc ") = "abc " * </pre> * * @param str 要处理的字符串 * @return 除去空白的字符串，如果原字串为<code>null</code>或结果字符串为<code>""</code>，则返回 <code>null</code> */ public static String trimStart(CharSequence str) { return trim(str, -1); } /** * 除去字符串尾部的空白，如果字符串是<code>null</code>，则返回<code>null</code>。 * * <p> * 注意，和<code>String.trim</code>不同，此方法使用<code>CharUtil.isBlankChar</code> 来判定空白， 因而可以除去英文字符集之外的其它空白，如中文空格。 * * <pre> * trimEnd(null) = null * trimEnd("") = "" * trimEnd("abc") = "abc" * trimEnd(" abc") = " abc" * trimEnd("abc ") = "abc" * trimEnd(" abc ") = " abc" * </pre> * * @param str 要处理的字符串 * @return 除去空白的字符串，如果原字串为<code>null</code>或结果字符串为<code>""</code>，则返回 <code>null</code> */ public static String trimEnd(CharSequence str) { return trim(str, 1); } /** * 除去字符串头尾部的空白符，如果字符串是<code>null</code>，依然返回<code>null</code>。 * * @param str 要处理的字符串 * @param mode <code>-1</code>表示trimStart，<code>0</code>表示trim全部， <code>1</code>表示trimEnd * @return 除去指定字符后的的字符串，如果原字串为<code>null</code>，则返回<code>null</code> */ public static String trim(CharSequence str, int mode) { if (str == null) { return null; } int length = str.length(); int start = 0; int end = length; // 扫描字符串头部 if (mode <= 0) { while ((start < end) && (CharUtil.isBlankChar(str.charAt(start)))) { start++; } } // 扫描字符串尾部 if (mode >= 0) { while ((start < end) && (CharUtil.isBlankChar(str.charAt(end - 1)))) { end--; } } if ((start > 0) || (end < length)) { return str.toString().substring(start, end); } return str.toString(); } /** * 字符串是否以给定字符开始 * * @param str 字符串 * @param c 字符 * @return 是否开始 */ public static boolean startWith(CharSequence str, char c) { return c == str.charAt(0); } /** * 是否以指定字符串开头<br> * 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false * * @param str 被监测字符串 * @param prefix 开头字符串 * @param isIgnoreCase 是否忽略大小写 * @return 是否以指定字符串开头 */ public static boolean startWith(CharSequence str, CharSequence prefix, boolean isIgnoreCase) { if (null == str || null == prefix) { return null == str && null == prefix; } if (isIgnoreCase) { return str.toString().toLowerCase().startsWith(prefix.toString().toLowerCase()); } else { return str.toString().startsWith(prefix.toString()); } } /** * 是否以指定字符串开头 * * @param str 被监测字符串 * @param prefix 开头字符串 * @return 是否以指定字符串开头 */ public static boolean startWith(CharSequence str, CharSequence prefix) { return startWith(str, prefix, false); } /** * 是否以指定字符串开头，忽略大小写 * * @param str 被监测字符串 * @param prefix 开头字符串 * @return 是否以指定字符串开头 */ public static boolean startWithIgnoreCase(CharSequence str, CharSequence prefix) { return startWith(str, prefix, true); } /** * 给定字符串是否以任何一个字符串开始<br> * 给定字符串和数组为空都返回false * * @param str 给定字符串 * @param prefixes 需要检测的开始字符串 * @return 给定字符串是否以任何一个字符串开始 * @since 3.0.6 */ public static boolean startWithAny(CharSequence str, CharSequence... prefixes) { if (isEmpty(str) || ArrayUtil.isEmpty(prefixes)) { return false; } for (CharSequence suffix : prefixes) { if (startWith(str, suffix, false)) { return true; } } return false; } /** * 字符串是否以给定字符结尾 * * @param str 字符串 * @param c 字符 * @return 是否结尾 */ public static boolean endWith(CharSequence str, char c) { return c == str.charAt(str.length() - 1); } /** * 是否以指定字符串结尾<br> * 如果给定的字符串和开头字符串都为null则返回true，否则任意一个值为null返回false * * @param str 被监测字符串 * @param suffix 结尾字符串 * @param isIgnoreCase 是否忽略大小写 * @return 是否以指定字符串结尾 */ public static boolean endWith(CharSequence str, CharSequence suffix, boolean isIgnoreCase) { if (null == str || null == suffix) { return null == str && null == suffix; } if (isIgnoreCase) { return str.toString().toLowerCase().endsWith(suffix.toString().toLowerCase()); } else { return str.toString().endsWith(suffix.toString()); } } /** * 是否以指定字符串结尾 * * @param str 被监测字符串 * @param suffix 结尾字符串 * @return 是否以指定字符串结尾 */ public static boolean endWith(CharSequence str, CharSequence suffix) { return endWith(str, suffix, false); } /** * 是否以指定字符串结尾，忽略大小写 * * @param str 被监测字符串 * @param suffix 结尾字符串 * @return 是否以指定字符串结尾 */ public static boolean endWithIgnoreCase(CharSequence str, CharSequence suffix) { return endWith(str, suffix, true); } /** * 给定字符串是否以任何一个字符串结尾<br> * 给定字符串和数组为空都返回false * * @param str 给定字符串 * @param suffixes 需要检测的结尾字符串 * @return 给定字符串是否以任何一个字符串结尾 * @since 3.0.6 */ public static boolean endWithAny(CharSequence str, CharSequence... suffixes) { if (isEmpty(str) || ArrayUtil.isEmpty(suffixes)) { return false; } for (CharSequence suffix : suffixes) { if (endWith(str, suffix, false)) { return true; } } return false; } /** * 指定字符是否在字符串中出现过 * * @param str 字符串 * @param searchChar 被查找的字符 * @return 是否包含 * @since 3.1.2 */ public static boolean contains(CharSequence str, char searchChar) { return indexOf(str, searchChar) > -1; } /** * 指定字符串是否在字符串中出现过 * * @param str 字符串 * @param searchStr 被查找的字符串 * @return 是否包含 * @since 5.1.1 */ public static boolean contains(CharSequence str, CharSequence searchStr) { if (null == str || null == searchStr) { return false; } return str.toString().contains(searchStr); } /** * 查找指定字符串是否包含指定字符串列表中的任意一个字符串 * * @param str 指定字符串 * @param testStrs 需要检查的字符串数组 * @return 是否包含任意一个字符串 * @since 3.2.0 */ public static boolean containsAny(CharSequence str, CharSequence... testStrs) { return null != getContainsStr(str, testStrs); } /** * 查找指定字符串是否包含指定字符列表中的任意一个字符 * * @param str 指定字符串 * @param testChars 需要检查的字符数组 * @return 是否包含任意一个字符 * @since 4.1.11 */ public static boolean containsAny(CharSequence str, char... testChars) { if (false == isEmpty(str)) { int len = str.length(); for (int i = 0; i < len; i++) { if (ArrayUtil.contains(testChars, str.charAt(i))) { return true; } } } return false; } /** * 检查指定字符串中是否只包含给定的字符 * * @param str 字符串 * @param testChars 检查的字符 * @return 字符串含有非检查的字符，返回false * @since 4.4.1 */ public static boolean containsOnly(CharSequence str, char... testChars) { if (false == isEmpty(str)) { int len = str.length(); for (int i = 0; i < len; i++) { if (false == ArrayUtil.contains(testChars, str.charAt(i))) { return false; } } } return true; } /** * 给定字符串是否包含空白符（空白符包括空格、制表符、全角空格和不间断空格）<br> * 如果给定字符串为null或者""，则返回false * * @param str 字符串 * @return 是否包含空白符 * @since 4.0.8 */ public static boolean containsBlank(CharSequence str) { if (null == str) { return false; } final int length = str.length(); if (0 == length) { return false; } for (int i = 0; i < length; i += 1) { if (CharUtil.isBlankChar(str.charAt(i))) { return true; } } return false; } /** * 查找指定字符串是否包含指定字符串列表中的任意一个字符串，如果包含返回找到的第一个字符串 * * @param str 指定字符串 * @param testStrs 需要检查的字符串数组 * @return 被包含的第一个字符串 * @since 3.2.0 */ public static String getContainsStr(CharSequence str, CharSequence... testStrs) { if (isEmpty(str) || ArrayUtil.isEmpty(testStrs)) { return null; } for (CharSequence checkStr : testStrs) { if (str.toString().contains(checkStr)) { return checkStr.toString(); } } return null; } /** * 是否包含特定字符，忽略大小写，如果给定两个参数都为<code>null</code>，返回true * * @param str 被检测字符串 * @param testStr 被测试是否包含的字符串 * @return 是否包含 */ public static boolean containsIgnoreCase(CharSequence str, CharSequence testStr) { if (null == str) { // 如果被监测字符串和 return null == testStr; } return str.toString().toLowerCase().contains(testStr.toString().toLowerCase()); } /** * 查找指定字符串是否包含指定字符串列表中的任意一个字符串<br> * 忽略大小写 * * @param str 指定字符串 * @param testStrs 需要检查的字符串数组 * @return 是否包含任意一个字符串 * @since 3.2.0 */ public static boolean containsAnyIgnoreCase(CharSequence str, CharSequence... testStrs) { return null != getContainsStrIgnoreCase(str, testStrs); } /** * 查找指定字符串是否包含指定字符串列表中的任意一个字符串，如果包含返回找到的第一个字符串<br> * 忽略大小写 * * @param str 指定字符串 * @param testStrs 需要检查的字符串数组 * @return 被包含的第一个字符串 * @since 3.2.0 */ public static String getContainsStrIgnoreCase(CharSequence str, CharSequence... testStrs) { if (isEmpty(str) || ArrayUtil.isEmpty(testStrs)) { return null; } for (CharSequence testStr : testStrs) { if (containsIgnoreCase(str, testStr)) { return testStr.toString(); } } return null; } /** * 获得set或get或is方法对应的标准属性名<br> * 例如：setName 返回 name * * <pre> * getName =》name * setName =》name * isName =》name * </pre> * * @param getOrSetMethodName Get或Set方法名 * @return 如果是set或get方法名，返回field， 否则null */ public static String getGeneralField(CharSequence getOrSetMethodName) { final String getOrSetMethodNameStr = getOrSetMethodName.toString(); if (getOrSetMethodNameStr.startsWith("get") || getOrSetMethodNameStr.startsWith("set")) { return removePreAndLowerFirst(getOrSetMethodName, 3); } else if (getOrSetMethodNameStr.startsWith("is")) { return removePreAndLowerFirst(getOrSetMethodName, 2); } return null; } /** * 生成set方法名<br> * 例如：name 返回 setName * * @param fieldName 属性名 * @return setXxx */ public static String genSetter(CharSequence fieldName) { return upperFirstAndAddPre(fieldName, "set"); } /** * 生成get方法名 * * @param fieldName 属性名 * @return getXxx */ public static String genGetter(CharSequence fieldName) { return upperFirstAndAddPre(fieldName, "get"); } /** * 移除字符串中所有给定字符串<br> * 例：removeAll("aa-bb-cc-dd", "-") =》 aabbccdd * * @param str 字符串 * @param strToRemove 被移除的字符串 * @return 移除后的字符串 */ public static String removeAll(CharSequence str, CharSequence strToRemove) { if (isEmpty(str)) { return str(str); } return str.toString().replace(strToRemove, EMPTY); } /** * 去除字符串中指定的多个字符，如有多个则全部去除 * * @param str 字符串 * @param chars 字符列表 * @return 去除后的字符 * @since 4.2.2 */ public static String removeAll(CharSequence str, char... chars) { if (null == str || ArrayUtil.isEmpty(chars)) { return str(str); } final int len = str.length(); if (0 == len) { return str(str); } final StringBuilder builder = builder(len); char c; for (int i = 0; i < len; i++) { c = str.charAt(i); if (false == ArrayUtil.contains(chars, c)) { builder.append(c); } } return builder.toString(); } /** * 去除所有换行符，包括： * * <pre> * 1. \r * 1. \n * </pre> * * @param str 字符串 * @return 处理后的字符串 * @since 4.2.2 */ public static String removeAllLineBreaks(CharSequence str) { return removeAll(str, C_CR, C_LF); } /** * 去掉首部指定长度的字符串并将剩余字符串首字母小写<br> * 例如：str=setName, preLength=3 =》 return name * * @param str 被处理的字符串 * @param preLength 去掉的长度 * @return 处理后的字符串，不符合规范返回null */ public static String removePreAndLowerFirst(CharSequence str, int preLength) { if (str == null) { return null; } if (str.length() > preLength) { char first = Character.toLowerCase(str.charAt(preLength)); if (str.length() > preLength + 1) { return first + str.toString().substring(preLength + 1); } return String.valueOf(first); } else { return str.toString(); } } /** * 去掉首部指定长度的字符串并将剩余字符串首字母小写<br> * 例如：str=setName, prefix=set =》 return name * * @param str 被处理的字符串 * @param prefix 前缀 * @return 处理后的字符串，不符合规范返回null */ public static String removePreAndLowerFirst(CharSequence str, CharSequence prefix) { return lowerFirst(removePrefix(str, prefix)); } /** * 原字符串首字母大写并在其首部添加指定字符串 例如：str=name, preString=get =》 return getName * * @param str 被处理的字符串 * @param preString 添加的首部 * @return 处理后的字符串 */ public static String upperFirstAndAddPre(CharSequence str, String preString) { if (str == null || preString == null) { return null; } return preString + upperFirst(str); } /** * 大写首字母<br> * 例如：str = name, return Name * * @param str 字符串 * @return 字符串 */ public static String upperFirst(CharSequence str) { if (null == str) { return null; } if (str.length() > 0) { char firstChar = str.charAt(0); if (Character.isLowerCase(firstChar)) { return Character.toUpperCase(firstChar) + subSuf(str, 1); } } return str.toString(); } /** * 小写首字母<br> * 例如：str = Name, return name * * @param str 字符串 * @return 字符串 */ public static String lowerFirst(CharSequence str) { if (null == str) { return null; } if (str.length() > 0) { char firstChar = str.charAt(0); if (Character.isUpperCase(firstChar)) { return Character.toLowerCase(firstChar) + subSuf(str, 1); } } return str.toString(); } /** * 去掉指定前缀 * * @param str 字符串 * @param prefix 前缀 * @return 切掉后的字符串，若前缀不是 preffix， 返回原字符串 */ public static String removePrefix(CharSequence str, CharSequence prefix) { if (isEmpty(str) || isEmpty(prefix)) { return str(str); } final String str2 = str.toString(); if (str2.startsWith(prefix.toString())) { return subSuf(str2, prefix.length());// 截取后半段 } return str2; } /** * 忽略大小写去掉指定前缀 * * @param str 字符串 * @param prefix 前缀 * @return 切掉后的字符串，若前缀不是 prefix， 返回原字符串 */ public static String removePrefixIgnoreCase(CharSequence str, CharSequence prefix) { if (isEmpty(str) || isEmpty(prefix)) { return str(str); } final String str2 = str.toString(); if (str2.toLowerCase().startsWith(prefix.toString().toLowerCase())) { return subSuf(str2, prefix.length());// 截取后半段 } return str2; } /** * 去掉指定后缀 * * @param str 字符串 * @param suffix 后缀 * @return 切掉后的字符串，若后缀不是 suffix， 返回原字符串 */ public static String removeSuffix(CharSequence str, CharSequence suffix) { if (isEmpty(str) || isEmpty(suffix)) { return str(str); } final String str2 = str.toString(); if (str2.endsWith(suffix.toString())) { return subPre(str2, str2.length() - suffix.length());// 截取前半段 } return str2; } /** * 去掉指定后缀，并小写首字母 * * @param str 字符串 * @param suffix 后缀 * @return 切掉后的字符串，若后缀不是 suffix， 返回原字符串 */ public static String removeSufAndLowerFirst(CharSequence str, CharSequence suffix) { return lowerFirst(removeSuffix(str, suffix)); } /** * 忽略大小写去掉指定后缀 * * @param str 字符串 * @param suffix 后缀 * @return 切掉后的字符串，若后缀不是 suffix， 返回原字符串 */ public static String removeSuffixIgnoreCase(CharSequence str, CharSequence suffix) { if (isEmpty(str) || isEmpty(suffix)) { return str(str); } final String str2 = str.toString(); if (str2.toLowerCase().endsWith(suffix.toString().toLowerCase())) { return subPre(str2, str2.length() - suffix.length()); } return str2; } /** * 去除两边的指定字符串 * * @param str 被处理的字符串 * @param prefixOrSuffix 前缀或后缀 * @return 处理后的字符串 * @since 3.1.2 */ public static String strip(CharSequence str, CharSequence prefixOrSuffix) { if (equals(str, prefixOrSuffix)) { // 对于去除相同字符的情况单独处理 return EMPTY; } return strip(str, prefixOrSuffix, prefixOrSuffix); } /** * 去除两边的指定字符串 * * @param str 被处理的字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 处理后的字符串 * @since 3.1.2 */ public static String strip(CharSequence str, CharSequence prefix, CharSequence suffix) { if (isEmpty(str)) { return str(str); } int from = 0; int to = str.length(); String str2 = str.toString(); if (startWith(str2, prefix)) { from = prefix.length(); } if (endWith(str2, suffix)) { to -= suffix.length(); } return str2.substring(Math.min(from, to), Math.max(from, to)); } /** * 去除两边的指定字符串，忽略大小写 * * @param str 被处理的字符串 * @param prefixOrSuffix 前缀或后缀 * @return 处理后的字符串 * @since 3.1.2 */ public static String stripIgnoreCase(CharSequence str, CharSequence prefixOrSuffix) { return stripIgnoreCase(str, prefixOrSuffix, prefixOrSuffix); } /** * 去除两边的指定字符串，忽略大小写 * * @param str 被处理的字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 处理后的字符串 * @since 3.1.2 */ public static String stripIgnoreCase(CharSequence str, CharSequence prefix, CharSequence suffix) { if (isEmpty(str)) { return str(str); } int from = 0; int to = str.length(); String str2 = str.toString(); if (startWithIgnoreCase(str2, prefix)) { from = prefix.length(); } if (endWithIgnoreCase(str2, suffix)) { to -= suffix.length(); } return str2.substring(from, to); } /** * 如果给定字符串不是以prefix开头的，在开头补充 prefix * * @param str 字符串 * @param prefix 前缀 * @return 补充后的字符串 */ public static String addPrefixIfNot(CharSequence str, CharSequence prefix) { if (isEmpty(str) || isEmpty(prefix)) { return str(str); } final String str2 = str.toString(); final String prefix2 = prefix.toString(); if (false == str2.startsWith(prefix2)) { return prefix2.concat(str2); } return str2; } /** * 如果给定字符串不是以suffix结尾的，在尾部补充 suffix * * @param str 字符串 * @param suffix 后缀 * @return 补充后的字符串 */ public static String addSuffixIfNot(CharSequence str, CharSequence suffix) { if (isEmpty(str) || isEmpty(suffix)) { return str(str); } final String str2 = str.toString(); final String suffix2 = suffix.toString(); if (false == str2.endsWith(suffix2)) { return str2.concat(suffix2); } return str2; } /** * 清理空白字符 * * @param str 被清理的字符串 * @return 清理后的字符串 */ public static String cleanBlank(CharSequence str) { if (str == null) { return null; } int len = str.length(); final StringBuilder sb = new StringBuilder(len); char c; for (int i = 0; i < len; i++) { c = str.charAt(i); if (false == CharUtil.isBlankChar(c)) { sb.append(c); } } return sb.toString(); } // ------------------------------------------------------------------------------ Split /** * 切分字符串 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @return 切分后的数组 */ public static String[] splitToArray(CharSequence str, char separator) { return splitToArray(str, separator, 0); } /** * 切分字符串为long数组 * * @param str 被切分的字符串 * @param separator 分隔符 * @return 切分后long数组 * @since 4.0.6 */ public static long[] splitToLong(CharSequence str, char separator) { return Convert.convert(long[].class, splitTrim(str, separator)); } /** * 切分字符串为long数组 * * @param str 被切分的字符串 * @param separator 分隔符字符串 * @return 切分后long数组 * @since 4.0.6 */ public static long[] splitToLong(CharSequence str, CharSequence separator) { return Convert.convert(long[].class, splitTrim(str, separator)); } /** * 切分字符串为int数组 * * @param str 被切分的字符串 * @param separator 分隔符 * @return 切分后long数组 * @since 4.0.6 */ public static int[] splitToInt(CharSequence str, char separator) { return Convert.convert(int[].class, splitTrim(str, separator)); } /** * 切分字符串为int数组 * * @param str 被切分的字符串 * @param separator 分隔符字符串 * @return 切分后long数组 * @since 4.0.6 */ public static int[] splitToInt(CharSequence str, CharSequence separator) { return Convert.convert(int[].class, splitTrim(str, separator)); } /** * 切分字符串<br> * a#b#c =》 [a,b,c] <br> * a##b#c =》 [a,"",b,c] * * @param str 被切分的字符串 * @param separator 分隔符字符 * @return 切分后的集合 */ public static List<String> split(CharSequence str, char separator) { return split(str, separator, 0); } /** * 切分字符串 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数 * @return 切分后的数组 */ public static String[] splitToArray(CharSequence str, char separator, int limit) { if (null == str) { return new String[]{ }; } return StrSpliter.splitToArray(str.toString(), separator, limit, false, false); } /** * 切分字符串，不去除切分后每个元素两边的空白符，不去除空白项 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数，-1不限制 * @return 切分后的集合 */ public static List<String> split(CharSequence str, char separator, int limit) { return split(str, separator, limit, false, false); } /** * 切分字符串，去除切分后每个元素两边的空白符，去除空白项 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @return 切分后的集合 * @since 3.1.2 */ public static List<String> splitTrim(CharSequence str, char separator) { return splitTrim(str, separator, -1); } /** * 切分字符串，去除切分后每个元素两边的空白符，去除空白项 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @return 切分后的集合 * @since 3.2.0 */ public static List<String> splitTrim(CharSequence str, CharSequence separator) { return splitTrim(str, separator, -1); } /** * 切分字符串，去除切分后每个元素两边的空白符，去除空白项 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数，-1不限制 * @return 切分后的集合 * @since 3.1.0 */ public static List<String> splitTrim(CharSequence str, char separator, int limit) { return split(str, separator, limit, true, true); } /** * 切分字符串，去除切分后每个元素两边的空白符，去除空白项 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数，-1不限制 * @return 切分后的集合 * @since 3.2.0 */ public static List<String> splitTrim(CharSequence str, CharSequence separator, int limit) { return split(str, separator, limit, true, true); } /** * 切分字符串，不限制分片数量 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param isTrim 是否去除切分字符串后每个元素两边的空格 * @param ignoreEmpty 是否忽略空串 * @return 切分后的集合 * @since 3.0.8 */ public static List<String> split(CharSequence str, char separator, boolean isTrim, boolean ignoreEmpty) { return split(str, separator, 0, isTrim, ignoreEmpty); } /** * 切分字符串 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数，-1不限制 * @param isTrim 是否去除切分字符串后每个元素两边的空格 * @param ignoreEmpty 是否忽略空串 * @return 切分后的集合 * @since 3.0.8 */ public static List<String> split(CharSequence str, char separator, int limit, boolean isTrim, boolean ignoreEmpty) { if (null == str) { return new ArrayList<>(0); } return StrSpliter.split(str.toString(), separator, limit, isTrim, ignoreEmpty); } /** * 切分字符串 * * @param str 被切分的字符串 * @param separator 分隔符字符 * @param limit 限制分片数，-1不限制 * @param isTrim 是否去除切分字符串后每个元素两边的空格 * @param ignoreEmpty 是否忽略空串 * @return 切分后的集合 * @since 3.2.0 */ public static List<String> split(CharSequence str, CharSequence separator, int limit, boolean isTrim, boolean ignoreEmpty) { if (null == str) { return new ArrayList<>(0); } final String separatorStr = (null == separator) ? null : separator.toString(); return StrSpliter.split(str.toString(), separatorStr, limit, isTrim, ignoreEmpty); } /** * 切分字符串，如果分隔符不存在则返回原字符串 * * @param str 被切分的字符串 * @param separator 分隔符 * @return 字符串 */ public static String[] split(CharSequence str, CharSequence separator) { if (str == null) { return new String[]{ }; } final String separatorStr = (null == separator) ? null : separator.toString(); return StrSpliter.splitToArray(str.toString(), separatorStr, 0, false, false); } /** * 根据给定长度，将给定字符串截取为多个部分 * * @param str 字符串 * @param len 每一个小节的长度 * @return 截取后的字符串数组 * @see StrSpliter#splitByLength(String, int) */ public static String[] split(CharSequence str, int len) { if (null == str) { return new String[]{ }; } return StrSpliter.splitByLength(str.toString(), len); } /** * 改进JDK subString<br> * index从0开始计算，最后一个字符为-1<br> * 如果from和to位置一样，返回 "" <br> * 如果from或to为负数，则按照length从后向前数位置，如果绝对值大于字符串长度，则from归到0，to归到length<br> * 如果经过修正的index中from大于to，则互换from和to example: <br> * abcdefgh 2 3 =》 c <br> * abcdefgh 2 -3 =》 cde <br> * * @param str String * @param fromIndex 开始的index（包括） * @param toIndex 结束的index（不包括） * @return 字串 */ public static String sub(CharSequence str, int fromIndex, int toIndex) { if (isEmpty(str)) { return str(str); } int len = str.length(); if (fromIndex < 0) { fromIndex = len + fromIndex; if (fromIndex < 0) { fromIndex = 0; } } else if (fromIndex > len) { fromIndex = len; } if (toIndex < 0) { toIndex = len + toIndex; if (toIndex < 0) { toIndex = len; } } else if (toIndex > len) { toIndex = len; } if (toIndex < fromIndex) { int tmp = fromIndex; fromIndex = toIndex; toIndex = tmp; } if (fromIndex == toIndex) { return EMPTY; } return str.toString().substring(fromIndex, toIndex); } /** * 通过CodePoint截取字符串，可以截断Emoji * * @param str String * @param fromIndex 开始的index（包括） * @param toIndex 结束的index（不包括） * @return 字串 */ public static String subByCodePoint(CharSequence str, int fromIndex, int toIndex) { if (isEmpty(str)) { return str(str); } if (fromIndex < 0 || fromIndex > toIndex) { throw new IllegalArgumentException(); } if (fromIndex == toIndex) { return EMPTY; } final StringBuilder sb = new StringBuilder(); final int subLen = toIndex - fromIndex; str.toString().codePoints().skip(fromIndex).limit(subLen).forEach(v -> sb.append(Character.toChars(v))); return sb.toString(); } /** * 截取部分字符串，这里一个汉字的长度认为是2 * * @param str 字符串 * @param len 切割的位置 * @param suffix 切割后加上后缀 * @return 切割后的字符串 * @since 3.1.1 */ public static String subPreGbk(CharSequence str, int len, CharSequence suffix) { if (isEmpty(str)) { return str(str); } byte[] b; int counterOfDoubleByte = 0; b = str.toString().getBytes(CharsetUtil.CHARSET_GBK); if (b.length <= len) { return str.toString(); } for (int i = 0; i < len; i++) { if (b[i] < 0) { counterOfDoubleByte++; } } if (counterOfDoubleByte % 2 != 0) { len += 1; } return new String(b, 0, len, CharsetUtil.CHARSET_GBK) + suffix; } /** * 限制字符串长度，如果超过指定长度，截取指定长度并在末尾加"..." * * @param string 字符串 * @param length 最大长度 * @return 切割后的剩余的前半部分字符串+"..." * @since 4.0.10 */ public static String maxLength(CharSequence string, int length) { Assert.isTrue(length > 0); if (null == string) { return null; } if (string.length() <= length) { return string.toString(); } return sub(string, 0, length) + "..."; } /** * 切割指定位置之前部分的字符串 * * @param string 字符串 * @param toIndex 切割到的位置（不包括） * @return 切割后的剩余的前半部分字符串 */ public static String subPre(CharSequence string, int toIndex) { return sub(string, 0, toIndex); } /** * 切割指定位置之后部分的字符串 * * @param string 字符串 * @param fromIndex 切割开始的位置（包括） * @return 切割后后剩余的后半部分字符串 */ public static String subSuf(CharSequence string, int fromIndex) { if (isEmpty(string)) { return null; } return sub(string, fromIndex, string.length()); } /** * 切割指定长度的后部分的字符串 * * <pre> * StrUtil.subSufByLength("abcde", 3) = "cde" * StrUtil.subSufByLength("abcde", 0) = "" * StrUtil.subSufByLength("abcde", -5) = "" * StrUtil.subSufByLength("abcde", -1) = "" * StrUtil.subSufByLength("abcde", 5) = "abcde" * StrUtil.subSufByLength("abcde", 10) = "abcde" * StrUtil.subSufByLength(null, 3) = null * </pre> * * @param string 字符串 * @param length 切割长度 * @return 切割后后剩余的后半部分字符串 * @since 4.0.1 */ public static String subSufByLength(CharSequence string, int length) { if (isEmpty(string)) { return null; } if (length <= 0) { return EMPTY; } return sub(string, -length, string.length()); } /** * 截取字符串,从指定位置开始,截取指定长度的字符串<br> * author weibaohui * * @param input 原始字符串 * @param fromIndex 开始的index,包括 * @param length 要截取的长度 * @return 截取后的字符串 */ public static String subWithLength(String input, int fromIndex, int length) { return sub(input, fromIndex, fromIndex + length); } /** * 截取分隔字符串之前的字符串，不包括分隔字符串<br> * 如果给定的字符串为空串（null或""）或者分隔字符串为null，返回原字符串<br> * 如果分隔字符串为空串""，则返回空串，如果分隔字符串未找到，返回原字符串，举例如下： * * <pre> * StrUtil.subBefore(null, *) = null * StrUtil.subBefore("", *) = "" * StrUtil.subBefore("abc", "a") = "" * StrUtil.subBefore("abcba", "b") = "a" * StrUtil.subBefore("abc", "c") = "ab" * StrUtil.subBefore("abc", "d") = "abc" * StrUtil.subBefore("abc", "") = "" * StrUtil.subBefore("abc", null) = "abc" * </pre> * * @param string 被查找的字符串 * @param separator 分隔字符串（不包括） * @param isLastSeparator 是否查找最后一个分隔字符串（多次出现分隔字符串时选取最后一个），true为选取最后一个 * @return 切割后的字符串 * @since 3.1.1 */ public static String subBefore(CharSequence string, CharSequence separator, boolean isLastSeparator) { if (isEmpty(string) || separator == null) { return null == string ? null : string.toString(); } final String str = string.toString(); final String sep = separator.toString(); if (sep.isEmpty()) { return EMPTY; } final int pos = isLastSeparator ? str.lastIndexOf(sep) : str.indexOf(sep); if (INDEX_NOT_FOUND == pos) { return str; } if (0 == pos) { return EMPTY; } return str.substring(0, pos); } /** * 截取分隔字符串之前的字符串，不包括分隔字符串<br> * 如果给定的字符串为空串（null或""）或者分隔字符串为null，返回原字符串<br> * 如果分隔字符串未找到，返回原字符串，举例如下： * * <pre> * StrUtil.subBefore(null, *) = null * StrUtil.subBefore("", *) = "" * StrUtil.subBefore("abc", 'a') = "" * StrUtil.subBefore("abcba", 'b') = "a" * StrUtil.subBefore("abc", 'c') = "ab" * StrUtil.subBefore("abc", 'd') = "abc" * </pre> * * @param string 被查找的字符串 * @param separator 分隔字符串（不包括） * @param isLastSeparator 是否查找最后一个分隔字符串（多次出现分隔字符串时选取最后一个），true为选取最后一个 * @return 切割后的字符串 * @since 4.1.15 */ public static String subBefore(CharSequence string, char separator, boolean isLastSeparator) { if (isEmpty(string)) { return null == string ? null : string.toString(); } final String str = string.toString(); final int pos = isLastSeparator ? str.lastIndexOf(separator) : str.indexOf(separator); if (INDEX_NOT_FOUND == pos) { return str; } if (0 == pos) { return EMPTY; } return str.substring(0, pos); } /** * 截取分隔字符串之后的字符串，不包括分隔字符串<br> * 如果给定的字符串为空串（null或""），返回原字符串<br> * 如果分隔字符串为空串（null或""），则返回空串，如果分隔字符串未找到，返回空串，举例如下： * * <pre> * StrUtil.subAfter(null, *) = null * StrUtil.subAfter("", *) = "" * StrUtil.subAfter(*, null) = "" * StrUtil.subAfter("abc", "a") = "bc" * StrUtil.subAfter("abcba", "b") = "cba" * StrUtil.subAfter("abc", "c") = "" * StrUtil.subAfter("abc", "d") = "" * StrUtil.subAfter("abc", "") = "abc" * </pre> * * @param string 被查找的字符串 * @param separator 分隔字符串（不包括） * @param isLastSeparator 是否查找最后一个分隔字符串（多次出现分隔字符串时选取最后一个），true为选取最后一个 * @return 切割后的字符串 * @since 3.1.1 */ public static String subAfter(CharSequence string, CharSequence separator, boolean isLastSeparator) { if (isEmpty(string)) { return null == string ? null : string.toString(); } if (separator == null) { return EMPTY; } final String str = string.toString(); final String sep = separator.toString(); final int pos = isLastSeparator ? str.lastIndexOf(sep) : str.indexOf(sep); if (INDEX_NOT_FOUND == pos || (string.length() - 1) == pos) { return EMPTY; } return str.substring(pos + separator.length()); } /** * 截取分隔字符串之后的字符串，不包括分隔字符串<br> * 如果给定的字符串为空串（null或""），返回原字符串<br> * 如果分隔字符串为空串（null或""），则返回空串，如果分隔字符串未找到，返回空串，举例如下： * * <pre> * StrUtil.subAfter(null, *) = null * StrUtil.subAfter("", *) = "" * StrUtil.subAfter("abc", 'a') = "bc" * StrUtil.subAfter("abcba", 'b') = "cba" * StrUtil.subAfter("abc", 'c') = "" * StrUtil.subAfter("abc", 'd') = "" * </pre> * * @param string 被查找的字符串 * @param separator 分隔字符串（不包括） * @param isLastSeparator 是否查找最后一个分隔字符串（多次出现分隔字符串时选取最后一个），true为选取最后一个 * @return 切割后的字符串 * @since 4.1.15 */ public static String subAfter(CharSequence string, char separator, boolean isLastSeparator) { if (isEmpty(string)) { return null == string ? null : string.toString(); } final String str = string.toString(); final int pos = isLastSeparator ? str.lastIndexOf(separator) : str.indexOf(separator); if (INDEX_NOT_FOUND == pos) { return EMPTY; } return str.substring(pos + 1); } /** * 截取指定字符串中间部分，不包括标识字符串<br> * <p> * 栗子： * * <pre> * StrUtil.subBetween("wx[b]yz", "[", "]") = "b" * StrUtil.subBetween(null, *, *) = null * StrUtil.subBetween(*, null, *) = null * StrUtil.subBetween(*, *, null) = null * StrUtil.subBetween("", "", "") = "" * StrUtil.subBetween("", "", "]") = null * StrUtil.subBetween("", "[", "]") = null * StrUtil.subBetween("yabcz", "", "") = "" * StrUtil.subBetween("yabcz", "y", "z") = "abc" * StrUtil.subBetween("yabczyabcz", "y", "z") = "abc" * </pre> * * @param str 被切割的字符串 * @param before 截取开始的字符串标识 * @param after 截取到的字符串标识 * @return 截取后的字符串 * @since 3.1.1 */ public static String subBetween(CharSequence str, CharSequence before, CharSequence after) { if (str == null || before == null || after == null) { return null; } final String str2 = str.toString(); final String before2 = before.toString(); final String after2 = after.toString(); final int start = str2.indexOf(before2); if (start != INDEX_NOT_FOUND) { final int end = str2.indexOf(after2, start + before2.length()); if (end != INDEX_NOT_FOUND) { return str2.substring(start + before2.length(), end); } } return null; } /** * 截取指定字符串中间部分，不包括标识字符串<br> * <p> * 栗子： * * <pre> * StrUtil.subBetween(null, *) = null * StrUtil.subBetween("", "") = "" * StrUtil.subBetween("", "tag") = null * StrUtil.subBetween("tagabctag", null) = null * StrUtil.subBetween("tagabctag", "") = "" * StrUtil.subBetween("tagabctag", "tag") = "abc" * </pre> * * @param str 被切割的字符串 * @param beforeAndAfter 截取开始和结束的字符串标识 * @return 截取后的字符串 * @since 3.1.1 */ public static String subBetween(CharSequence str, CharSequence beforeAndAfter) { return subBetween(str, beforeAndAfter, beforeAndAfter); } /** * 截取指定字符串多段中间部分，不包括标识字符串<br> * <p> * 栗子： * * <pre> * StrUtil.subBetweenAll("wx[b]y[z]", "[", "]") = ["b","z"] * StrUtil.subBetweenAll(null, *, *) = [] * StrUtil.subBetweenAll(*, null, *) = [] * StrUtil.subBetweenAll(*, *, null) = [] * StrUtil.subBetweenAll("", "", "") = [] * StrUtil.subBetweenAll("", "", "]") = [] * StrUtil.subBetweenAll("", "[", "]") = [] * StrUtil.subBetweenAll("yabcz", "", "") = [] * StrUtil.subBetweenAll("yabcz", "y", "z") = ["abc"] * StrUtil.subBetweenAll("yabczyabcz", "y", "z") = ["abc","abc"] * StrUtil.subBetweenAll("[yabc[zy]abcz]", "[", "]"); = ["zy"] 重叠时只截取内部， * </pre> * * @param str 被切割的字符串 * @param prefix 截取开始的字符串标识 * @param suffix 截取到的字符串标识 * @return 截取后的字符串 * @author dahuoyzs * @since 5.2.5 */ public static String[] subBetweenAll(CharSequence str, CharSequence prefix, CharSequence suffix) { if (hasEmpty(str, prefix, suffix) || // 不包含起始字符串，则肯定没有子串 false == contains(str, prefix)) { return new String[0]; } final List<String> result = new LinkedList<>(); final String[] split = split(str, prefix); for (String fragment : split(str, prefix)) { int suffixIndex = fragment.indexOf(suffix.toString()); if (suffixIndex > 0) { result.add(fragment.substring(0, suffixIndex)); } } return result.toArray(new String[0]); } /** * 给定字符串是否被字符包围 * * @param str 字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 是否包围，空串不包围 */ public static boolean isSurround(CharSequence str, CharSequence prefix, CharSequence suffix) { if (StrUtil.isBlank(str)) { return false; } if (str.length() < (prefix.length() + suffix.length())) { return false; } final String str2 = str.toString(); return str2.startsWith(prefix.toString()) && str2.endsWith(suffix.toString()); } /** * 给定字符串是否被字符包围 * * @param str 字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 是否包围，空串不包围 */ public static boolean isSurround(CharSequence str, char prefix, char suffix) { if (StrUtil.isBlank(str)) { return false; } if (str.length() < 2) { return false; } return str.charAt(0) == prefix && str.charAt(str.length() - 1) == suffix; } /** * 重复某个字符 * * @param c 被重复的字符 * @param count 重复的数目，如果小于等于0则返回"" * @return 重复字符字符串 */ public static String repeat(char c, int count) { if (count <= 0) { return EMPTY; } char[] result = new char[count]; for (int i = 0; i < count; i++) { result[i] = c; } return new String(result); } /** * 重复某个字符串 * * @param str 被重复的字符 * @param count 重复的数目 * @return 重复字符字符串 */ public static String repeat(CharSequence str, int count) { if (null == str) { return null; } if (count <= 0) { return EMPTY; } if (count == 1 || str.length() == 0) { return str.toString(); } // 检查 final int len = str.length(); final long longSize = (long) len * (long) count; final int size = (int) longSize; if (size != longSize) { throw new ArrayIndexOutOfBoundsException("Required String length is too large: " + longSize); } final char[] array = new char[size]; str.toString().getChars(0, len, array, 0); int n; for (n = len; n < size - n; n <<= 1) { // n <<= 1相当于n *2 System.arraycopy(array, 0, array, n, n); } System.arraycopy(array, 0, array, n, size - n); return new String(array); } /** * 重复某个字符串到指定长度 * * @param str 被重复的字符 * @param padLen 指定长度 * @return 重复字符字符串 * @since 4.3.2 */ public static String repeatByLength(CharSequence str, int padLen) { if (null == str) { return null; } if (padLen <= 0) { return StrUtil.EMPTY; } final int strLen = str.length(); if (strLen == padLen) { return str.toString(); } else if (strLen > padLen) { return subPre(str, padLen); } // 重复，直到达到指定长度 final char[] padding = new char[padLen]; for (int i = 0; i < padLen; i++) { padding[i] = str.charAt(i % strLen); } return new String(padding); } /** * 重复某个字符串并通过分界符连接 * * <pre> * StrUtil.repeatAndJoin("?", 5, ",") = "?,?,?,?,?" * StrUtil.repeatAndJoin("?", 0, ",") = "" * StrUtil.repeatAndJoin("?", 5, null) = "?????" * </pre> * * @param str 被重复的字符串 * @param count 数量 * @param conjunction 分界符 * @return 连接后的字符串 * @since 4.0.1 */ public static String repeatAndJoin(CharSequence str, int count, CharSequence conjunction) { if (count <= 0) { return EMPTY; } final StrBuilder builder = StrBuilder.create(); boolean isFirst = true; while (count-- > 0) { if (isFirst) { isFirst = false; } else if (isNotEmpty(conjunction)) { builder.append(conjunction); } builder.append(str); } return builder.toString(); } /** * 比较两个字符串（大小写敏感）。 * * <pre> * equals(null, null) = true * equals(null, "abc") = false * equals("abc", null) = false * equals("abc", "abc") = true * equals("abc", "ABC") = false * </pre> * * @param str1 要比较的字符串1 * @param str2 要比较的字符串2 * @return 如果两个字符串相同，或者都是<code>null</code>，则返回<code>true</code> */ public static boolean equals(CharSequence str1, CharSequence str2) { return equals(str1, str2, false); } /** * 比较两个字符串（大小写不敏感）。 * * <pre> * equalsIgnoreCase(null, null) = true * equalsIgnoreCase(null, "abc") = false * equalsIgnoreCase("abc", null) = false * equalsIgnoreCase("abc", "abc") = true * equalsIgnoreCase("abc", "ABC") = true * </pre> * * @param str1 要比较的字符串1 * @param str2 要比较的字符串2 * @return 如果两个字符串相同，或者都是<code>null</code>，则返回<code>true</code> */ public static boolean equalsIgnoreCase(CharSequence str1, CharSequence str2) { return equals(str1, str2, true); } /** * 比较两个字符串是否相等。 * * @param str1 要比较的字符串1 * @param str2 要比较的字符串2 * @param ignoreCase 是否忽略大小写 * @return 如果两个字符串相同，或者都是<code>null</code>，则返回<code>true</code> * @since 3.2.0 */ public static boolean equals(CharSequence str1, CharSequence str2, boolean ignoreCase) { if (null == str1) { // 只有两个都为null才判断相等 return str2 == null; } if (null == str2) { // 字符串2空，字符串1非空，直接false return false; } if (ignoreCase) { return str1.toString().equalsIgnoreCase(str2.toString()); } else { return str1.toString().contentEquals(str2); } } /** * 给定字符串是否与提供的中任一字符串相同（忽略大小写），相同则返回{@code true}，没有相同的返回{@code false}<br> * 如果参与比对的字符串列表为空，返回{@code false} * * @param str1 给定需要检查的字符串 * @param strs 需要参与比对的字符串列表 * @return 是否相同 * @since 4.3.2 */ public static boolean equalsAnyIgnoreCase(CharSequence str1, CharSequence... strs) { return equalsAny(str1, true, strs); } /** * 给定字符串是否与提供的中任一字符串相同，相同则返回{@code true}，没有相同的返回{@code false}<br> * 如果参与比对的字符串列表为空，返回{@code false} * * @param str1 给定需要检查的字符串 * @param strs 需要参与比对的字符串列表 * @return 是否相同 * @since 4.3.2 */ public static boolean equalsAny(CharSequence str1, CharSequence... strs) { return equalsAny(str1, false, strs); } /** * 给定字符串是否与提供的中任一字符串相同，相同则返回{@code true}，没有相同的返回{@code false}<br> * 如果参与比对的字符串列表为空，返回{@code false} * * @param str1 给定需要检查的字符串 * @param ignoreCase 是否忽略大小写 * @param strs 需要参与比对的字符串列表 * @return 是否相同 * @since 4.3.2 */ public static boolean equalsAny(CharSequence str1, boolean ignoreCase, CharSequence... strs) { if (ArrayUtil.isEmpty(strs)) { return false; } for (CharSequence str : strs) { if (equals(str1, str, ignoreCase)) { return true; } } return false; } /** * 格式化文本, {} 表示占位符<br> * 此方法只是简单将占位符 {} 按照顺序替换为参数<br> * 如果想输出 {} 使用 \\转义 { 即可，如果想输出 {} 之前的 \ 使用双转义符 \\\\ 即可<br> * 例：<br> * 通常使用：format("this is {} for {}", "a", "b") =》 this is a for b<br> * 转义{}： format("this is \\{} for {}", "a", "b") =》 this is \{} for a<br> * 转义\： format("this is \\\\{} for {}", "a", "b") =》 this is \a for b<br> * * @param template 文本模板，被替换的部分用 {} 表示 * @param params 参数值 * @return 格式化后的文本 */ public static String format(CharSequence template, Object... params) { if (null == template) { return null; } if (ArrayUtil.isEmpty(params) || isBlank(template)) { return template.toString(); } return StrFormatter.format(template.toString(), params); } /** * 有序的格式化文本，使用{number}做为占位符<br> * 例：<br> * 通常使用：format("this is {0} for {1}", "a", "b") =》 this is a for b<br> * * @param pattern 文本格式 * @param arguments 参数 * @return 格式化后的文本 */ public static String indexedFormat(CharSequence pattern, Object... arguments) { return MessageFormat.format(pattern.toString(), arguments); } /** * 格式化文本，使用 {varName} 占位<br> * map = {a: "aValue", b: "bValue"} format("{a} and {b}", map) ---=》 aValue and bValue * * @param template 文本模板，被替换的部分用 {key} 表示 * @param map 参数值对 * @return 格式化后的文本 */ public static String format(CharSequence template, Map<?, ?> map) { if (null == template) { return null; } if (null == map || map.isEmpty()) { return template.toString(); } String template2 = template.toString(); String value; for (Entry<?, ?> entry : map.entrySet()) { value = utf8Str(entry.getValue()); if (null != value) { template2 = replace(template2, "{" + entry.getKey() + "}", value); } } return template2; } /** * 编码字符串，编码为UTF-8 * * @param str 字符串 * @return 编码后的字节码 */ public static byte[] utf8Bytes(CharSequence str) { return bytes(str, CharsetUtil.CHARSET_UTF_8); } /** * 编码字符串<br> * 使用系统默认编码 * * @param str 字符串 * @return 编码后的字节码 */ public static byte[] bytes(CharSequence str) { return bytes(str, Charset.defaultCharset()); } /** * 编码字符串 * * @param str 字符串 * @param charset 字符集，如果此字段为空，则解码的结果取决于平台 * @return 编码后的字节码 */ public static byte[] bytes(CharSequence str, String charset) { return bytes(str, isBlank(charset) ? Charset.defaultCharset() : Charset.forName(charset)); } /** * 编码字符串 * * @param str 字符串 * @param charset 字符集，如果此字段为空，则解码的结果取决于平台 * @return 编码后的字节码 */ public static byte[] bytes(CharSequence str, Charset charset) { if (str == null) { return null; } if (null == charset) { return str.toString().getBytes(); } return str.toString().getBytes(charset); } /** * 将对象转为字符串<br> * 1、Byte数组和ByteBuffer会被转换为对应字符串的数组 2、对象数组会调用Arrays.toString方法 * * @param obj 对象 * @return 字符串 */ public static String utf8Str(Object obj) { return str(obj, CharsetUtil.CHARSET_UTF_8); } /** * 将对象转为字符串 * * <pre> * 1、Byte数组和ByteBuffer会被转换为对应字符串的数组 * 2、对象数组会调用Arrays.toString方法 * </pre> * * @param obj 对象 * @param charsetName 字符集 * @return 字符串 */ public static String str(Object obj, String charsetName) { return str(obj, Charset.forName(charsetName)); } /** * 将对象转为字符串 * <pre> * 1、Byte数组和ByteBuffer会被转换为对应字符串的数组 * 2、对象数组会调用Arrays.toString方法 * </pre> * * @param obj 对象 * @param charset 字符集 * @return 字符串 */ public static String str(Object obj, Charset charset) { if (null == obj) { return null; } if (obj instanceof String) { return (String) obj; } else if (obj instanceof byte[]) { return str((byte[]) obj, charset); } else if (obj instanceof Byte[]) { return str((Byte[]) obj, charset); } else if (obj instanceof ByteBuffer) { return str((ByteBuffer) obj, charset); } else if (ArrayUtil.isArray(obj)) { return ArrayUtil.toString(obj); } return obj.toString(); } /** * 将byte数组转为字符串 * * @param bytes byte数组 * @param charset 字符集 * @return 字符串 */ public static String str(byte[] bytes, String charset) { return str(bytes, isBlank(charset) ? Charset.defaultCharset() : Charset.forName(charset)); } /** * 解码字节码 * * @param data 字符串 * @param charset 字符集，如果此字段为空，则解码的结果取决于平台 * @return 解码后的字符串 */ public static String str(byte[] data, Charset charset) { if (data == null) { return null; } if (null == charset) { return new String(data); } return new String(data, charset); } /** * 将Byte数组转为字符串 * * @param bytes byte数组 * @param charset 字符集 * @return 字符串 */ public static String str(Byte[] bytes, String charset) { return str(bytes, isBlank(charset) ? Charset.defaultCharset() : Charset.forName(charset)); } /** * 解码字节码 * * @param data 字符串 * @param charset 字符集，如果此字段为空，则解码的结果取决于平台 * @return 解码后的字符串 */ public static String str(Byte[] data, Charset charset) { if (data == null) { return null; } byte[] bytes = new byte[data.length]; Byte dataByte; for (int i = 0; i < data.length; i++) { dataByte = data[i]; bytes[i] = (null == dataByte) ? -1 : dataByte; } return str(bytes, charset); } /** * 将编码的byteBuffer数据转换为字符串 * * @param data 数据 * @param charset 字符集，如果为空使用当前系统字符集 * @return 字符串 */ public static String str(ByteBuffer data, String charset) { if (data == null) { return null; } return str(data, Charset.forName(charset)); } /** * 将编码的byteBuffer数据转换为字符串 * * @param data 数据 * @param charset 字符集，如果为空使用当前系统字符集 * @return 字符串 */ public static String str(ByteBuffer data, Charset charset) { if (null == charset) { charset = Charset.defaultCharset(); } return charset.decode(data).toString(); } /** * {@link CharSequence} 转为字符串，null安全 * * @param cs {@link CharSequence} * @return 字符串 */ public static String str(CharSequence cs) { return null == cs ? null : cs.toString(); } /** * 调用对象的toString方法，null会返回“null” * * @param obj 对象 * @return 字符串 * @since 4.1.3 */ public static String toString(Object obj) { return null == obj ? NULL : obj.toString(); } /** * 字符串转换为byteBuffer * * @param str 字符串 * @param charset 编码 * @return byteBuffer */ public static ByteBuffer byteBuffer(CharSequence str, String charset) { return ByteBuffer.wrap(bytes(str, charset)); } /** * 以 conjunction 为分隔符将多个对象转换为字符串 * * @param conjunction 分隔符 * @param objs 数组 * @return 连接后的字符串 * @see ArrayUtil#join(Object, CharSequence) */ public static String join(CharSequence conjunction, Object... objs) { return ArrayUtil.join(objs, conjunction); } /** * 将驼峰式命名的字符串转换为下划线方式。如果转换前的驼峰式命名的字符串为空，则返回空字符串。<br> * 例如： * * <pre> * HelloWorld=》hello_world * Hello_World=》hello_world * HelloWorld_test=》hello_world_test * </pre> * * @param str 转换前的驼峰式命名的字符串，也可以为下划线形式 * @return 转换后下划线方式命名的字符串 */ public static String toUnderlineCase(CharSequence str) { return toSymbolCase(str, CharUtil.UNDERLINE); } /** * 将驼峰式命名的字符串转换为使用符号连接方式。如果转换前的驼峰式命名的字符串为空，则返回空字符串。<br> * * @param str 转换前的驼峰式命名的字符串，也可以为符号连接形式 * @param symbol 连接符 * @return 转换后符号连接方式命名的字符串 * @since 4.0.10 */ public static String toSymbolCase(CharSequence str, char symbol) { if (str == null) { return null; } final int length = str.length(); final StringBuilder sb = new StringBuilder(); char c; for (int i = 0; i < length; i++) { c = str.charAt(i); final Character preChar = (i > 0) ? str.charAt(i - 1) : null; if (Character.isUpperCase(c)) { // 遇到大写字母处理 final Character nextChar = (i < str.length() - 1) ? str.charAt(i + 1) : null; if (null != preChar && Character.isUpperCase(preChar)) { // 前一个字符为大写，则按照一个词对待 sb.append(c); } else if (null != nextChar && Character.isUpperCase(nextChar)) { // 后一个为大写字母，按照一个词对待 if (null != preChar && symbol != preChar) { // 前一个是非大写时按照新词对待，加连接符 sb.append(symbol); } sb.append(c); } else { // 前后都为非大写按照新词对待 if (null != preChar && symbol != preChar) { // 前一个非连接符，补充连接符 sb.append(symbol); } sb.append(Character.toLowerCase(c)); } } else { if (sb.length() > 0 && Character.isUpperCase(sb.charAt(sb.length() - 1)) && symbol != c) { // 当结果中前一个字母为大写，当前为小写，说明此字符为新词开始（连接符也表示新词） sb.append(symbol); } // 小写或符号 sb.append(c); } } return sb.toString(); } /** * 将下划线方式命名的字符串转换为驼峰式。如果转换前的下划线大写方式命名的字符串为空，则返回空字符串。<br> * 例如：hello_world=》helloWorld * * @param name 转换前的下划线大写方式命名的字符串 * @return 转换后的驼峰式命名的字符串 */ public static String toCamelCase(CharSequence name) { if (null == name) { return null; } String name2 = name.toString(); if (name2.contains(UNDERLINE)) { final StringBuilder sb = new StringBuilder(name2.length()); boolean upperCase = false; for (int i = 0; i < name2.length(); i++) { char c = name2.charAt(i); if (c == CharUtil.UNDERLINE) { upperCase = true; } else if (upperCase) { sb.append(Character.toUpperCase(c)); upperCase = false; } else { sb.append(Character.toLowerCase(c)); } } return sb.toString(); } else { return name2; } } /** * 包装指定字符串<br> * 当前缀和后缀一致时使用此方法 * * @param str 被包装的字符串 * @param prefixAndSuffix 前缀和后缀 * @return 包装后的字符串 * @since 3.1.0 */ public static String wrap(CharSequence str, CharSequence prefixAndSuffix) { return wrap(str, prefixAndSuffix, prefixAndSuffix); } /** * 包装指定字符串 * * @param str 被包装的字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 包装后的字符串 */ public static String wrap(CharSequence str, CharSequence prefix, CharSequence suffix) { return nullToEmpty(prefix).concat(nullToEmpty(str)).concat(nullToEmpty(suffix)); } /** * 包装多个字符串 * * @param prefixAndSuffix 前缀和后缀 * @param strs 多个字符串 * @return 包装的字符串数组 * @since 4.0.7 */ public static String[] wrapAll(CharSequence prefixAndSuffix, CharSequence... strs) { return wrapAll(prefixAndSuffix, prefixAndSuffix, strs); } /** * 包装多个字符串 * * @param prefix 前缀 * @param suffix 后缀 * @param strs 多个字符串 * @return 包装的字符串数组 * @since 4.0.7 */ public static String[] wrapAll(CharSequence prefix, CharSequence suffix, CharSequence... strs) { final String[] results = new String[strs.length]; for (int i = 0; i < strs.length; i++) { results[i] = wrap(strs[i], prefix, suffix); } return results; } /** * 包装指定字符串，如果前缀或后缀已经包含对应的字符串，则不再包装 * * @param str 被包装的字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 包装后的字符串 */ public static String wrapIfMissing(CharSequence str, CharSequence prefix, CharSequence suffix) { int len = 0; if (isNotEmpty(str)) { len += str.length(); } if (isNotEmpty(prefix)) { len += str.length(); } if (isNotEmpty(suffix)) { len += str.length(); } StringBuilder sb = new StringBuilder(len); if (isNotEmpty(prefix) && false == startWith(str, prefix)) { sb.append(prefix); } if (isNotEmpty(str)) { sb.append(str); } if (isNotEmpty(suffix) && false == endWith(str, suffix)) { sb.append(suffix); } return sb.toString(); } /** * 包装多个字符串，如果已经包装，则不再包装 * * @param prefixAndSuffix 前缀和后缀 * @param strs 多个字符串 * @return 包装的字符串数组 * @since 4.0.7 */ public static String[] wrapAllIfMissing(CharSequence prefixAndSuffix, CharSequence... strs) { return wrapAllIfMissing(prefixAndSuffix, prefixAndSuffix, strs); } /** * 包装多个字符串，如果已经包装，则不再包装 * * @param prefix 前缀 * @param suffix 后缀 * @param strs 多个字符串 * @return 包装的字符串数组 * @since 4.0.7 */ public static String[] wrapAllIfMissing(CharSequence prefix, CharSequence suffix, CharSequence... strs) { final String[] results = new String[strs.length]; for (int i = 0; i < strs.length; i++) { results[i] = wrapIfMissing(strs[i], prefix, suffix); } return results; } /** * 去掉字符包装，如果未被包装则返回原字符串 * * @param str 字符串 * @param prefix 前置字符串 * @param suffix 后置字符串 * @return 去掉包装字符的字符串 * @since 4.0.1 */ public static String unWrap(CharSequence str, String prefix, String suffix) { if (isWrap(str, prefix, suffix)) { return sub(str, prefix.length(), str.length() - suffix.length()); } return str.toString(); } /** * 去掉字符包装，如果未被包装则返回原字符串 * * @param str 字符串 * @param prefix 前置字符 * @param suffix 后置字符 * @return 去掉包装字符的字符串 * @since 4.0.1 */ public static String unWrap(CharSequence str, char prefix, char suffix) { if (isEmpty(str)) { return str(str); } if (str.charAt(0) == prefix && str.charAt(str.length() - 1) == suffix) { return sub(str, 1, str.length() - 1); } return str.toString(); } /** * 去掉字符包装，如果未被包装则返回原字符串 * * @param str 字符串 * @param prefixAndSuffix 前置和后置字符 * @return 去掉包装字符的字符串 * @since 4.0.1 */ public static String unWrap(CharSequence str, char prefixAndSuffix) { return unWrap(str, prefixAndSuffix, prefixAndSuffix); } /** * 指定字符串是否被包装 * * @param str 字符串 * @param prefix 前缀 * @param suffix 后缀 * @return 是否被包装 */ public static boolean isWrap(CharSequence str, String prefix, String suffix) { if (ArrayUtil.hasNull(str, prefix, suffix)) { return false; } final String str2 = str.toString(); return str2.startsWith(prefix) && str2.endsWith(suffix); } /** * 指定字符串是否被同一字符包装（前后都有这些字符串） * * @param str 字符串 * @param wrapper 包装字符串 * @return 是否被包装 */ public static boolean isWrap(CharSequence str, String wrapper) { return isWrap(str, wrapper, wrapper); } /** * 指定字符串是否被同一字符包装（前后都有这些字符串） * * @param str 字符串 * @param wrapper 包装字符 * @return 是否被包装 */ public static boolean isWrap(CharSequence str, char wrapper) { return isWrap(str, wrapper, wrapper); } /** * 指定字符串是否被包装 * * @param str 字符串 * @param prefixChar 前缀 * @param suffixChar 后缀 * @return 是否被包装 */ public static boolean isWrap(CharSequence str, char prefixChar, char suffixChar) { if (null == str) { return false; } return str.charAt(0) == prefixChar && str.charAt(str.length() - 1) == suffixChar; } /** * 补充字符串以满足最小长度 * * <pre> * StrUtil.padPre(null, *, *);//null * StrUtil.padPre("1", 3, "ABC");//"AB1" * StrUtil.padPre("123", 2, "ABC");//"12" * </pre> * * @param str 字符串 * @param minLength 最小长度 * @param padStr 补充的字符 * @return 补充后的字符串 */ public static String padPre(CharSequence str, int minLength, CharSequence padStr) { if (null == str) { return null; } final int strLen = str.length(); if (strLen == minLength) { return str.toString(); } else if (strLen > minLength) { return subPre(str, minLength); } return repeatByLength(padStr, minLength - strLen).concat(str.toString()); } /** * 补充字符串以满足最小长度 * * <pre> * StrUtil.padPre(null, *, *);//null * StrUtil.padPre("1", 3, '0');//"001" * StrUtil.padPre("123", 2, '0');//"12" * </pre> * * @param str 字符串 * @param minLength 最小长度 * @param padChar 补充的字符 * @return 补充后的字符串 */ public static String padPre(CharSequence str, int minLength, char padChar) { if (null == str) { return null; } final int strLen = str.length(); if (strLen == minLength) { return str.toString(); } else if (strLen > minLength) { return subPre(str, minLength); } return repeat(padChar, minLength - strLen).concat(str.toString()); } /** * 补充字符串以满足最小长度 * * <pre> * StrUtil.padAfter(null, *, *);//null * StrUtil.padAfter("1", 3, '0');//"100" * StrUtil.padAfter("123", 2, '0');//"23" * </pre> * * @param str 字符串，如果为<code>null</code>，按照空串处理 * @param minLength 最小长度 * @param padChar 补充的字符 * @return 补充后的字符串 */ public static String padAfter(CharSequence str, int minLength, char padChar) { if (null == str) { return null; } final int strLen = str.length(); if (strLen == minLength) { return str.toString(); } else if (strLen > minLength) { return sub(str, strLen - minLength, strLen); } return str.toString().concat(repeat(padChar, minLength - strLen)); } /** * 补充字符串以满足最小长度 * * <pre> * StrUtil.padAfter(null, *, *);//null * StrUtil.padAfter("1", 3, "ABC");//"1AB" * StrUtil.padAfter("123", 2, "ABC");//"23" * </pre> * * @param str 字符串，如果为<code>null</code>，按照空串处理 * @param minLength 最小长度 * @param padStr 补充的字符 * @return 补充后的字符串 * @since 4.3.2 */ public static String padAfter(CharSequence str, int minLength, CharSequence padStr) { if (null == str) { return null; } final int strLen = str.length(); if (strLen == minLength) { return str.toString(); } else if (strLen > minLength) { return subSufByLength(str, minLength); } return str.toString().concat(repeatByLength(padStr, minLength - strLen)); } /** * 居中字符串，两边补充指定字符串，如果指定长度小于字符串，则返回原字符串 * * <pre> * StrUtil.center(null, *) = null * StrUtil.center("", 4) = " " * StrUtil.center("ab", -1) = "ab" * StrUtil.center("ab", 4) = " ab " * StrUtil.center("abcd", 2) = "abcd" * StrUtil.center("a", 4) = " a " * </pre> * * @param str 字符串 * @param size 指定长度 * @return 补充后的字符串 * @since 4.3.2 */ public static String center(CharSequence str, final int size) { return center(str, size, CharUtil.SPACE); } /** * 居中字符串，两边补充指定字符串，如果指定长度小于字符串，则返回原字符串 * * <pre> * StrUtil.center(null, *, *) = null * StrUtil.center("", 4, ' ') = " " * StrUtil.center("ab", -1, ' ') = "ab" * StrUtil.center("ab", 4, ' ') = " ab " * StrUtil.center("abcd", 2, ' ') = "abcd" * StrUtil.center("a", 4, ' ') = " a " * StrUtil.center("a", 4, 'y') = "yayy" * StrUtil.center("abc", 7, ' ') = " abc " * </pre> * * @param str 字符串 * @param size 指定长度 * @param padChar 两边补充的字符 * @return 补充后的字符串 * @since 4.3.2 */ public static String center(CharSequence str, final int size, char padChar) { if (str == null || size <= 0) { return str(str); } final int strLen = str.length(); final int pads = size - strLen; if (pads <= 0) { return str.toString(); } str = padPre(str, strLen + pads / 2, padChar); str = padAfter(str, size, padChar); return str.toString(); } /** * 居中字符串，两边补充指定字符串，如果指定长度小于字符串，则返回原字符串 * * <pre> * StrUtil.center(null, *, *) = null * StrUtil.center("", 4, " ") = " " * StrUtil.center("ab", -1, " ") = "ab" * StrUtil.center("ab", 4, " ") = " ab " * StrUtil.center("abcd", 2, " ") = "abcd" * StrUtil.center("a", 4, " ") = " a " * StrUtil.center("a", 4, "yz") = "yayz" * StrUtil.center("abc", 7, null) = " abc " * StrUtil.center("abc", 7, "") = " abc " * </pre> * * @param str 字符串 * @param size 指定长度 * @param padStr 两边补充的字符串 * @return 补充后的字符串 */ public static String center(CharSequence str, final int size, CharSequence padStr) { if (str == null || size <= 0) { return str(str); } if (isEmpty(padStr)) { padStr = SPACE; } final int strLen = str.length(); final int pads = size - strLen; if (pads <= 0) { return str.toString(); } str = padPre(str, strLen + pads / 2, padStr); str = padAfter(str, size, padStr); return str.toString(); } /** * 创建StringBuilder对象 * * @return StringBuilder对象 */ public static StringBuilder builder() { return new StringBuilder(); } /** * 创建StrBuilder对象 * * @return StrBuilder对象 * @since 4.0.1 */ public static StrBuilder strBuilder() { return StrBuilder.create(); } /** * 创建StringBuilder对象 * * @param capacity 初始大小 * @return StringBuilder对象 */ public static StringBuilder builder(int capacity) { return new StringBuilder(capacity); } /** * 创建StrBuilder对象 * * @param capacity 初始大小 * @return StrBuilder对象 * @since 4.0.1 */ public static StrBuilder strBuilder(int capacity) { return StrBuilder.create(capacity); } /** * 创建StringBuilder对象 * * @param strs 初始字符串列表 * @return StringBuilder对象 */ public static StringBuilder builder(CharSequence... strs) { final StringBuilder sb = new StringBuilder(); for (CharSequence str : strs) { sb.append(str); } return sb; } /** * 创建StrBuilder对象 * * @param strs 初始字符串列表 * @return StrBuilder对象 */ public static StrBuilder strBuilder(CharSequence... strs) { return StrBuilder.create(strs); } /** * 获得StringReader * * @param str 字符串 * @return StringReader */ public static StringReader getReader(CharSequence str) { if (null == str) { return null; } return new StringReader(str.toString()); } /** * 获得StringWriter * * @return StringWriter */ public static StringWriter getWriter() { return new StringWriter(); } /** * 统计指定内容中包含指定字符串的数量<br> * 参数为 {@code null} 或者 "" 返回 {@code 0}. * * <pre> * StrUtil.count(null, *) = 0 * StrUtil.count("", *) = 0 * StrUtil.count("abba", null) = 0 * StrUtil.count("abba", "") = 0 * StrUtil.count("abba", "a") = 2 * StrUtil.count("abba", "ab") = 1 * StrUtil.count("abba", "xxx") = 0 * </pre> * * @param content 被查找的字符串 * @param strForSearch 需要查找的字符串 * @return 查找到的个数 */ public static int count(CharSequence content, CharSequence strForSearch) { if (hasEmpty(content, strForSearch) || strForSearch.length() > content.length()) { return 0; } int count = 0; int idx = 0; final String content2 = content.toString(); final String strForSearch2 = strForSearch.toString(); while ((idx = content2.indexOf(strForSearch2, idx)) > -1) { count++; idx += strForSearch.length(); } return count; } /** * 统计指定内容中包含指定字符的数量 * * @param content 内容 * @param charForSearch 被统计的字符 * @return 包含数量 */ public static int count(CharSequence content, char charForSearch) { int count = 0; if (isEmpty(content)) { return 0; } int contentLength = content.length(); for (int i = 0; i < contentLength; i++) { if (charForSearch == content.charAt(i)) { count++; } } return count; } /** * 将字符串切分为N等份 * * @param str 字符串 * @param partLength 每等份的长度 * @return 切分后的数组 * @since 3.0.6 */ public static String[] cut(CharSequence str, int partLength) { if (null == str) { return null; } int len = str.length(); if (len < partLength) { return new String[]{ str.toString()}; } int part = NumberUtil.count(len, partLength); final String[] array = new String[part]; final String str2 = str.toString(); for (int i = 0; i < part; i++) { array[i] = str2.substring(i * partLength, (i == part - 1) ? len : (partLength + i * partLength)); } return array; } /** * 将给定字符串，变成 "xxx...xxx" 形式的字符串 * * @param str 字符串 * @param maxLength 最大长度 * @return 截取后的字符串 */ public static String brief(CharSequence str, int maxLength) { if (null == str) { return null; } if ((str.length() + 3) <= maxLength) { return str.toString(); } int w = maxLength / 2; int l = str.length(); final String str2 = str.toString(); return format("{}...{}", str2.substring(0, maxLength - w), str2.substring(l - w)); } /** * 比较两个字符串，用于排序 * * <pre> * StrUtil.compare(null, null, *) = 0 * StrUtil.compare(null , "a", true) < 0 * StrUtil.compare(null , "a", false) > 0 * StrUtil.compare("a", null, true) > 0 * StrUtil.compare("a", null, false) < 0 * StrUtil.compare("abc", "abc", *) = 0 * StrUtil.compare("a", "b", *) < 0 * StrUtil.compare("b", "a", *) > 0 * StrUtil.compare("a", "B", *) > 0 * StrUtil.compare("ab", "abc", *) < 0 * </pre> * * @param str1 字符串1 * @param str2 字符串2 * @param nullIsLess {@code null} 值是否排在前（null是否小于非空值） * @return 排序值。负数：str1 < str2，正数：str1 > str2, 0：str1 == str2 */ public static int compare(final CharSequence str1, final CharSequence str2, final boolean nullIsLess) { if (str1 == str2) { return 0; } if (str1 == null) { return nullIsLess ? -1 : 1; } if (str2 == null) { return nullIsLess ? 1 : -1; } return str1.toString().compareTo(str2.toString()); } /** * 比较两个字符串，用于排序，大小写不敏感 * * <pre> * StrUtil.compareIgnoreCase(null, null, *) = 0 * StrUtil.compareIgnoreCase(null , "a", true) < 0 * StrUtil.compareIgnoreCase(null , "a", false) > 0 * StrUtil.compareIgnoreCase("a", null, true) > 0 * StrUtil.compareIgnoreCase("a", null, false) < 0 * StrUtil.compareIgnoreCase("abc", "abc", *) = 0 * StrUtil.compareIgnoreCase("abc", "ABC", *) = 0 * StrUtil.compareIgnoreCase("a", "b", *) < 0 * StrUtil.compareIgnoreCase("b", "a", *) > 0 * StrUtil.compareIgnoreCase("a", "B", *) < 0 * StrUtil.compareIgnoreCase("A", "b", *) < 0 * StrUtil.compareIgnoreCase("ab", "abc", *) < 0 * </pre> * * @param str1 字符串1 * @param str2 字符串2 * @param nullIsLess {@code null} 值是否排在前（null是否小于非空值） * @return 排序值。负数：str1 < str2，正数：str1 > str2, 0：str1 == str2 */ public static int compareIgnoreCase(CharSequence str1, CharSequence str2, boolean nullIsLess) { if (str1 == str2) { return 0; } if (str1 == null) { return nullIsLess ? -1 : 1; } if (str2 == null) { return nullIsLess ? 1 : -1; } return str1.toString().compareToIgnoreCase(str2.toString()); } /** * 比较两个版本<br> * null版本排在最小：即： * * <pre> * StrUtil.compareVersion(null, "v1") < 0 * StrUtil.compareVersion("v1", "v1") = 0 * StrUtil.compareVersion(null, null) = 0 * StrUtil.compareVersion("v1", null) > 0 * StrUtil.compareVersion("1.0.0", "1.0.2") < 0 * StrUtil.compareVersion("1.0.2", "1.0.2a") < 0 * StrUtil.compareVersion("1.13.0", "1.12.1c") > 0 * StrUtil.compareVersion("V0.0.20170102", "V0.0.20170101") > 0 * </pre> * * @param version1 版本1 * @param version2 版本2 * @return 排序值。负数：version1 < version2，正数：version1 > version2, 0：version1 == version2 * @since 4.0.2 */ public static int compareVersion(CharSequence version1, CharSequence version2) { return VersionComparator.INSTANCE.compare(str(version1), str(version2)); } /** * 指定范围内查找指定字符 * * @param str 字符串 * @param searchChar 被查找的字符 * @return 位置 */ public static int indexOf(final CharSequence str, char searchChar) { return indexOf(str, searchChar, 0); } /** * 指定范围内查找指定字符 * * @param str 字符串 * @param searchChar 被查找的字符 * @param start 起始位置，如果小于0，从0开始查找 * @return 位置 */ public static int indexOf(final CharSequence str, char searchChar, int start) { if (str instanceof String) { return ((String) str).indexOf(searchChar, start); } else { return indexOf(str, searchChar, start, -1); } } /** * 指定范围内查找指定字符 * * @param str 字符串 * @param searchChar 被查找的字符 * @param start 起始位置，如果小于0，从0开始查找 * @param end 终止位置，如果超过str.length()则默认查找到字符串末尾 * @return 位置 */ public static int indexOf(final CharSequence str, char searchChar, int start, int end) { final int len = str.length(); if (start < 0 || start > len) { start = 0; } if (end > len || end < 0) { end = len; } for (int i = start; i < end; i++) { if (str.charAt(i) == searchChar) { return i; } } return -1; } /** * 指定范围内查找字符串，忽略大小写<br> * * <pre> * StrUtil.indexOfIgnoreCase(null, *, *) = -1 * StrUtil.indexOfIgnoreCase(*, null, *) = -1 * StrUtil.indexOfIgnoreCase("", "", 0) = 0 * StrUtil.indexOfIgnoreCase("aabaabaa", "A", 0) = 0 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 0) = 2 * StrUtil.indexOfIgnoreCase("aabaabaa", "AB", 0) = 1 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 3) = 5 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 9) = -1 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", -1) = 2 * StrUtil.indexOfIgnoreCase("aabaabaa", "", 2) = 2 * StrUtil.indexOfIgnoreCase("abc", "", 9) = -1 * </pre> * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @return 位置 * @since 3.2.1 */ public static int indexOfIgnoreCase(final CharSequence str, final CharSequence searchStr) { return indexOfIgnoreCase(str, searchStr, 0); } /** * 指定范围内查找字符串 * * <pre> * StrUtil.indexOfIgnoreCase(null, *, *) = -1 * StrUtil.indexOfIgnoreCase(*, null, *) = -1 * StrUtil.indexOfIgnoreCase("", "", 0) = 0 * StrUtil.indexOfIgnoreCase("aabaabaa", "A", 0) = 0 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 0) = 2 * StrUtil.indexOfIgnoreCase("aabaabaa", "AB", 0) = 1 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 3) = 5 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", 9) = -1 * StrUtil.indexOfIgnoreCase("aabaabaa", "B", -1) = 2 * StrUtil.indexOfIgnoreCase("aabaabaa", "", 2) = 2 * StrUtil.indexOfIgnoreCase("abc", "", 9) = -1 * </pre> * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @param fromIndex 起始位置 * @return 位置 * @since 3.2.1 */ public static int indexOfIgnoreCase(final CharSequence str, final CharSequence searchStr, int fromIndex) { return indexOf(str, searchStr, fromIndex, true); } /** * 指定范围内查找字符串 * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @param fromIndex 起始位置 * @param ignoreCase 是否忽略大小写 * @return 位置 * @since 3.2.1 */ public static int indexOf(final CharSequence str, CharSequence searchStr, int fromIndex, boolean ignoreCase) { if (str == null || searchStr == null) { return INDEX_NOT_FOUND; } if (fromIndex < 0) { fromIndex = 0; } final int endLimit = str.length() - searchStr.length() + 1; if (fromIndex > endLimit) { return INDEX_NOT_FOUND; } if (searchStr.length() == 0) { return fromIndex; } if (false == ignoreCase) { // 不忽略大小写调用JDK方法 return str.toString().indexOf(searchStr.toString(), fromIndex); } for (int i = fromIndex; i < endLimit; i++) { if (isSubEquals(str, i, searchStr, 0, searchStr.length(), true)) { return i; } } return INDEX_NOT_FOUND; } /** * 指定范围内查找字符串，忽略大小写 * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @return 位置 * @since 3.2.1 */ public static int lastIndexOfIgnoreCase(final CharSequence str, final CharSequence searchStr) { return lastIndexOfIgnoreCase(str, searchStr, str.length()); } /** * 指定范围内查找字符串，忽略大小写<br> * fromIndex 为搜索起始位置，从后往前计数 * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @param fromIndex 起始位置，从后往前计数 * @return 位置 * @since 3.2.1 */ public static int lastIndexOfIgnoreCase(final CharSequence str, final CharSequence searchStr, int fromIndex) { return lastIndexOf(str, searchStr, fromIndex, true); } /** * 指定范围内查找字符串<br> * fromIndex 为搜索起始位置，从后往前计数 * * @param str 字符串 * @param searchStr 需要查找位置的字符串 * @param fromIndex 起始位置，从后往前计数 * @param ignoreCase 是否忽略大小写 * @return 位置 * @since 3.2.1 */ public static int lastIndexOf(final CharSequence str, final CharSequence searchStr, int fromIndex, boolean ignoreCase) { if (str == null || searchStr == null) { return INDEX_NOT_FOUND; } if (fromIndex < 0) { fromIndex = 0; } fromIndex = Math.min(fromIndex, str.length()); if (searchStr.length() == 0) { return fromIndex; } if (false == ignoreCase) { // 不忽略大小写调用JDK方法 return str.toString().lastIndexOf(searchStr.toString(), fromIndex); } for (int i = fromIndex; i > 0; i--) { if (isSubEquals(str, i, searchStr, 0, searchStr.length(), true)) { return i; } } return INDEX_NOT_FOUND; } /** * 返回字符串 searchStr 在字符串 str 中第 ordinal 次出现的位置。 * * <p> * 如果 str=null 或 searchStr=null 或 ordinal≥0 则返回-1<br> * 此方法来自：Apache-Commons-Lang * <p> * 例子（*代表任意字符）： * * <pre> * StrUtil.ordinalIndexOf(null, *, *) = -1 * StrUtil.ordinalIndexOf(*, null, *) = -1 * StrUtil.ordinalIndexOf("", "", *) = 0 * StrUtil.ordinalIndexOf("aabaabaa", "a", 1) = 0 * StrUtil.ordinalIndexOf("aabaabaa", "a", 2) = 1 * StrUtil.ordinalIndexOf("aabaabaa", "b", 1) = 2 * StrUtil.ordinalIndexOf("aabaabaa", "b", 2) = 5 * StrUtil.ordinalIndexOf("aabaabaa", "ab", 1) = 1 * StrUtil.ordinalIndexOf("aabaabaa", "ab", 2) = 4 * StrUtil.ordinalIndexOf("aabaabaa", "", 1) = 0 * StrUtil.ordinalIndexOf("aabaabaa", "", 2) = 0 * </pre> * * @param str 被检查的字符串，可以为null * @param searchStr 被查找的字符串，可以为null * @param ordinal 第几次出现的位置 * @return 查找到的位置 * @since 3.2.3 */ public static int ordinalIndexOf(String str, String searchStr, int ordinal) { if (str == null || searchStr == null || ordinal <= 0) { return INDEX_NOT_FOUND; } if (searchStr.length() == 0) { return 0; } int found = 0; int index = INDEX_NOT_FOUND; do { index = str.indexOf(searchStr, index + 1); if (index < 0) { return index; } found++; } while (found < ordinal); return index; } // ------------------------------------------------------------------------------------------------------------------ Append and prepend /** * 如果给定字符串不是以给定的一个或多个字符串为结尾，则在尾部添加结尾字符串<br> * 不忽略大小写 * * @param str 被检查的字符串 * @param suffix 需要添加到结尾的字符串 * @param suffixes 需要额外检查的结尾字符串，如果以这些中的一个为结尾，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String appendIfMissing(final CharSequence str, final CharSequence suffix, final CharSequence... suffixes) { return appendIfMissing(str, suffix, false, suffixes); } /** * 如果给定字符串不是以给定的一个或多个字符串为结尾，则在尾部添加结尾字符串<br> * 忽略大小写 * * @param str 被检查的字符串 * @param suffix 需要添加到结尾的字符串 * @param suffixes 需要额外检查的结尾字符串，如果以这些中的一个为结尾，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String appendIfMissingIgnoreCase(final CharSequence str, final CharSequence suffix, final CharSequence... suffixes) { return appendIfMissing(str, suffix, true, suffixes); } /** * 如果给定字符串不是以给定的一个或多个字符串为结尾，则在尾部添加结尾字符串 * * @param str 被检查的字符串 * @param suffix 需要添加到结尾的字符串 * @param ignoreCase 检查结尾时是否忽略大小写 * @param suffixes 需要额外检查的结尾字符串，如果以这些中的一个为结尾，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String appendIfMissing(final CharSequence str, final CharSequence suffix, final boolean ignoreCase, final CharSequence... suffixes) { if (str == null || isEmpty(suffix) || endWith(str, suffix, ignoreCase)) { return str(str); } if (suffixes != null && suffixes.length > 0) { for (final CharSequence s : suffixes) { if (endWith(str, s, ignoreCase)) { return str.toString(); } } } return str.toString().concat(suffix.toString()); } /** * 如果给定字符串不是以给定的一个或多个字符串为开头，则在首部添加起始字符串<br> * 不忽略大小写 * * @param str 被检查的字符串 * @param prefix 需要添加到首部的字符串 * @param prefixes 需要额外检查的首部字符串，如果以这些中的一个为起始，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String prependIfMissing(final CharSequence str, final CharSequence prefix, final CharSequence... prefixes) { return prependIfMissing(str, prefix, false, prefixes); } /** * 如果给定字符串不是以给定的一个或多个字符串为开头，则在首部添加起始字符串<br> * 忽略大小写 * * @param str 被检查的字符串 * @param prefix 需要添加到首部的字符串 * @param prefixes 需要额外检查的首部字符串，如果以这些中的一个为起始，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String prependIfMissingIgnoreCase(final CharSequence str, final CharSequence prefix, final CharSequence... prefixes) { return prependIfMissing(str, prefix, true, prefixes); } /** * 如果给定字符串不是以给定的一个或多个字符串为开头，则在首部添加起始字符串 * * @param str 被检查的字符串 * @param prefix 需要添加到首部的字符串 * @param ignoreCase 检查结尾时是否忽略大小写 * @param prefixes 需要额外检查的首部字符串，如果以这些中的一个为起始，则不再添加 * @return 如果已经结尾，返回原字符串，否则返回添加结尾的字符串 * @since 3.0.7 */ public static String prependIfMissing(final CharSequence str, final CharSequence prefix, final boolean ignoreCase, final CharSequence... prefixes) { if (str == null || isEmpty(prefix) || startWith(str, prefix, ignoreCase)) { return str(str); } if (prefixes != null && prefixes.length > 0) { for (final CharSequence s : prefixes) { if (startWith(str, s, ignoreCase)) { return str.toString(); } } } return prefix.toString().concat(str.toString()); } /** * 反转字符串<br> * 例如：abcd =》dcba * * @param str 被反转的字符串 * @return 反转后的字符串 * @since 3.0.9 */ public static String reverse(String str) { return new String(ArrayUtil.reverse(str.toCharArray())); } /** * 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串<br> * 字符填充于字符串前 * * @param str 被填充的字符串 * @param filledChar 填充的字符 * @param len 填充长度 * @return 填充后的字符串 * @since 3.1.2 */ public static String fillBefore(String str, char filledChar, int len) { return fill(str, filledChar, len, true); } /** * 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串<br> * 字符填充于字符串后 * * @param str 被填充的字符串 * @param filledChar 填充的字符 * @param len 填充长度 * @return 填充后的字符串 * @since 3.1.2 */ public static String fillAfter(String str, char filledChar, int len) { return fill(str, filledChar, len, false); } /** * 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串 * * @param str 被填充的字符串 * @param filledChar 填充的字符 * @param len 填充长度 * @param isPre 是否填充在前 * @return 填充后的字符串 * @since 3.1.2 */ public static String fill(String str, char filledChar, int len, boolean isPre) { final int strLen = str.length(); if (strLen > len) { return str; } String filledStr = StrUtil.repeat(filledChar, len - strLen); return isPre ? filledStr.concat(str) : str.concat(filledStr); } /** * 截取两个字符串的不同部分（长度一致），判断截取的子串是否相同<br> * 任意一个字符串为null返回false * * @param str1 第一个字符串 * @param start1 第一个字符串开始的位置 * @param str2 第二个字符串 * @param start2 第二个字符串开始的位置 * @param length 截取长度 * @param ignoreCase 是否忽略大小写 * @return 子串是否相同 * @since 3.2.1 */ public static boolean isSubEquals(CharSequence str1, int start1, CharSequence str2, int start2, int length, boolean ignoreCase) { if (null == str1 || null == str2) { return false; } return str1.toString().regionMatches(ignoreCase, start1, str2.toString(), start2, length); } /** * 字符串的每一个字符是否都与定义的匹配器匹配 * * @param value 字符串 * @param matcher 匹配器 * @return 是否全部匹配 * @since 3.2.3 */ public static boolean isAllCharMatch(CharSequence value, Matcher<Character> matcher) { if (StrUtil.isBlank(value)) { return false; } int len = value.length(); boolean isAllMatch = true; for (int i = 0; i < len; i++) { isAllMatch &= matcher.match(value.charAt(i)); } return isAllMatch; } /** * 替换字符串中的指定字符串，忽略大小写 * * @param str 字符串 * @param searchStr 被查找的字符串 * @param replacement 被替换的字符串 * @return 替换后的字符串 * @since 4.0.3 */ public static String replaceIgnoreCase(CharSequence str, CharSequence searchStr, CharSequence replacement) { return replace(str, 0, searchStr, replacement, true); } /** * 替换字符串中的指定字符串 * * @param str 字符串 * @param searchStr 被查找的字符串 * @param replacement 被替换的字符串 * @return 替换后的字符串 * @since 4.0.3 */ public static String replace(CharSequence str, CharSequence searchStr, CharSequence replacement) { return replace(str, 0, searchStr, replacement, false); } /** * 替换字符串中的指定字符串 * * @param str 字符串 * @param searchStr 被查找的字符串 * @param replacement 被替换的字符串 * @param ignoreCase 是否忽略大小写 * @return 替换后的字符串 * @since 4.0.3 */ public static String replace(CharSequence str, CharSequence searchStr, CharSequence replacement, boolean ignoreCase) { return replace(str, 0, searchStr, replacement, ignoreCase); } /** * 替换字符串中的指定字符串 * * @param str 字符串 * @param fromIndex 开始位置（包括） * @param searchStr 被查找的字符串 * @param replacement 被替换的字符串 * @param ignoreCase 是否忽略大小写 * @return 替换后的字符串 * @since 4.0.3 */ public static String replace(CharSequence str, int fromIndex, CharSequence searchStr, CharSequence replacement, boolean ignoreCase) { if (isEmpty(str) || isEmpty(searchStr)) { return str(str); } if (null == replacement) { replacement = EMPTY; } final int strLength = str.length(); final int searchStrLength = searchStr.length(); if (fromIndex > strLength) { return str(str); } else if (fromIndex < 0) { fromIndex = 0; } final StrBuilder result = StrBuilder.create(strLength + 16); if (0 != fromIndex) { result.append(str.subSequence(0, fromIndex)); } int preIndex = fromIndex; int index; while ((index = indexOf(str, searchStr, preIndex, ignoreCase)) > -1) { result.append(str.subSequence(preIndex, index)); result.append(replacement); preIndex = index + searchStrLength; } if (preIndex < strLength) { // 结尾部分 result.append(str.subSequence(preIndex, strLength)); } return result.toString(); } /** * 替换指定字符串的指定区间内字符为固定字符 * * @param str 字符串 * @param startInclude 开始位置（包含） * @param endExclude 结束位置（不包含） * @param replacedChar 被替换的字符 * @return 替换后的字符串 * @since 3.2.1 */ public static String replace(CharSequence str, int startInclude, int endExclude, char replacedChar) { if (isEmpty(str)) { return str(str); } final int strLength = str.length(); if (startInclude > strLength) { return str(str); } if (endExclude > strLength) { endExclude = strLength; } if (startInclude > endExclude) { // 如果起始位置大于结束位置，不替换 return str(str); } final char[] chars = new char[strLength]; for (int i = 0; i < strLength; i++) { if (i >= startInclude && i < endExclude) { chars[i] = replacedChar; } else { chars[i] = str.charAt(i); } } return new String(chars); } /** * 替换所有正则匹配的文本，并使用自定义函数决定如何替换 * * @param str 要替换的字符串 * @param pattern 用于匹配的正则式 * @param replaceFun 决定如何替换的函数 * @return 替换后的字符串 * @see ReUtil#replaceAll(CharSequence, Pattern, Func1) * @since 4.2.2 */ public static String replace(CharSequence str, Pattern pattern, Func1<java.util.regex.Matcher, String> replaceFun) { return ReUtil.replaceAll(str, pattern, replaceFun); } /** * 替换所有正则匹配的文本，并使用自定义函数决定如何替换 * * @param str 要替换的字符串 * @param regex 用于匹配的正则式 * @param replaceFun 决定如何替换的函数 * @return 替换后的字符串 * @see ReUtil#replaceAll(CharSequence, String, Func1) * @since 4.2.2 */ public static String replace(CharSequence str, String regex, Func1<java.util.regex.Matcher, String> replaceFun) { return ReUtil.replaceAll(str, regex, replaceFun); } /** * 替换指定字符串的指定区间内字符为"*" * * @param str 字符串 * @param startInclude 开始位置（包含） * @param endExclude 结束位置（不包含） * @return 替换后的字符串 * @since 4.1.14 */ public static String hide(CharSequence str, int startInclude, int endExclude) { return replace(str, startInclude, endExclude, '*'); } /** * 替换字符字符数组中所有的字符为replacedStr<br> * 提供的chars为所有需要被替换的字符，例如："\r\n"，则"\r"和"\n"都会被替换，哪怕他们单独存在 * * @param str 被检查的字符串 * @param chars 需要替换的字符列表，用一个字符串表示这个字符列表 * @param replacedStr 替换成的字符串 * @return 新字符串 * @since 3.2.2 */ public static String replaceChars(CharSequence str, String chars, CharSequence replacedStr) { if (isEmpty(str) || isEmpty(chars)) { return str(str); } return replaceChars(str, chars.toCharArray(), replacedStr); } /** * 替换字符字符数组中所有的字符为replacedStr * * @param str 被检查的字符串 * @param chars 需要替换的字符列表 * @param replacedStr 替换成的字符串 * @return 新字符串 * @since 3.2.2 */ public static String replaceChars(CharSequence str, char[] chars, CharSequence replacedStr) { if (isEmpty(str) || ArrayUtil.isEmpty(chars)) { return str(str); } final Set<Character> set = new HashSet<>(chars.length); for (char c : chars) { set.add(c); } int strLen = str.length(); final StringBuilder builder = builder(); char c; for (int i = 0; i < strLen; i++) { c = str.charAt(i); builder.append(set.contains(c) ? replacedStr : c); } return builder.toString(); } /** * 计算两个字符串的相似度 * * @param str1 字符串1 * @param str2 字符串2 * @return 相似度 * @since 3.2.3 */ public static double similar(String str1, String str2) { return TextSimilarity.similar(str1, str2); } /** * 计算连个字符串的相似度百分比 * * @param str1 字符串1 * @param str2 字符串2 * @param scale 相似度 * @return 相似度百分比 * @since 3.2.3 */ public static String similar(String str1, String str2, int scale) { return TextSimilarity.similar(str1, str2, scale); } /** * 字符串指定位置的字符是否与给定字符相同<br> * 如果字符串为null，返回false<br> * 如果给定的位置大于字符串长度，返回false<br> * 如果给定的位置小于0，返回false * * @param str 字符串 * @param position 位置 * @param c 需要对比的字符 * @return 字符串指定位置的字符是否与给定字符相同 * @since 3.3.1 */ public static boolean equalsCharAt(CharSequence str, int position, char c) { if (null == str || position < 0) { return false; } return str.length() > position && c == str.charAt(position); } /** * 给定字符串数组的总长度<br> * null字符长度定义为0 * * @param strs 字符串数组 * @return 总长度 * @since 4.0.1 */ public static int totalLength(CharSequence... strs) { int totalLength = 0; for (CharSequence str : strs) { totalLength += (null == str ? 0 : str.length()); } return totalLength; } /** * 循环位移指定位置的字符串为指定距离<br> * 当moveLength大于0向右位移，小于0向左位移，0不位移<br> * 当moveLength大于字符串长度时采取循环位移策略，即位移到头后从头（尾）位移，例如长度为10，位移13则表示位移3 * * @param str 字符串 * @param startInclude 起始位置（包括） * @param endExclude 结束位置（不包括） * @param moveLength 移动距离，负数表示左移，正数为右移 * @return 位移后的字符串 * @since 4.0.7 */ public static String move(CharSequence str, int startInclude, int endExclude, int moveLength) { if (isEmpty(str)) { return str(str); } int len = str.length(); if (Math.abs(moveLength) > len) { // 循环位移，当越界时循环 moveLength = moveLength % len; } final StrBuilder strBuilder = StrBuilder.create(len); if (moveLength > 0) { int endAfterMove = Math.min(endExclude + moveLength, str.length()); strBuilder.append(str.subSequence(0, startInclude))// .append(str.subSequence(endExclude, endAfterMove))// .append(str.subSequence(startInclude, endExclude))// .append(str.subSequence(endAfterMove, str.length())); } else if (moveLength < 0) { int startAfterMove = Math.max(startInclude + moveLength, 0); strBuilder.append(str.subSequence(0, startAfterMove))// .append(str.subSequence(startInclude, endExclude))// .append(str.subSequence(startAfterMove, startInclude))// .append(str.subSequence(endExclude, str.length())); } else { return str(str); } return strBuilder.toString(); } /** * 生成随机UUID * * @return UUID字符串 * @see IdUtil#randomUUID() * @since 4.0.10 */ public static String uuid() { return IdUtil.randomUUID(); } /** * 连接多个字符串为一个 * * @param isNullToEmpty 是否null转为"" * @param strs 字符串数组 * @return 连接后的字符串 * @since 4.1.0 */ public static String concat(boolean isNullToEmpty, CharSequence... strs) { final StrBuilder sb = new StrBuilder(); for (CharSequence str : strs) { sb.append(isNullToEmpty ? nullToEmpty(str) : str); } return sb.toString(); } /** * 给定字符串中的字母是否全部为大写，判断依据如下： * * <pre> * 1. 大写字母包括A-Z * 2. 其它非字母的Unicode符都算作大写 * </pre> * * @param str 被检查的字符串 * @return 是否全部为大写 * @since 4.2.2 */ public static boolean isUpperCase(CharSequence str) { if (null == str) { return false; } final int len = str.length(); for (int i = 0; i < len; i++) { if (Character.isLowerCase(str.charAt(i))) { return false; } } return true; } /** * 给定字符串中的字母是否全部为小写，判断依据如下： * * <pre> * 1. 小写字母包括a-z * 2. 其它非字母的Unicode符都算作小写 * </pre> * * @param str 被检查的字符串 * @return 是否全部为小写 * @since 4.2.2 */ public static boolean isLowerCase(CharSequence str) { if (null == str) { return false; } final int len = str.length(); for (int i = 0; i < len; i++) { if (Character.isUpperCase(str.charAt(i))) { return false; } } return true; } /** * 获取字符串的长度，如果为null返回0 * * @param cs a 字符串 * @return 字符串的长度，如果为null返回0 * @since 4.3.2 */ public static int length(CharSequence cs) { return cs == null ? 0 : cs.length(); } /** * 给定字符串转为bytes后的byte数（byte长度） * * @param cs 字符串 * @param charset 编码 * @return byte长度 * @since 4.5.2 */ public static int byteLength(CharSequence cs, Charset charset) { return cs == null ? 0 : cs.toString().getBytes(charset).length; } /** * 切换给定字符串中的大小写。大写转小写，小写转大写。 * * <pre> * StrUtil.swapCase(null) = null * StrUtil.swapCase("") = "" * StrUtil.swapCase("The dog has a BONE") = "tHE DOG HAS A bone" * </pre> * * @param str 字符串 * @return 交换后的字符串 * @since 4.3.2 */ public static String swapCase(final String str) { if (isEmpty(str)) { return str; } final char[] buffer = str.toCharArray(); for (int i = 0; i < buffer.length; i++) { final char ch = buffer[i]; if (Character.isUpperCase(ch)) { buffer[i] = Character.toLowerCase(ch); } else if (Character.isTitleCase(ch)) { buffer[i] = Character.toLowerCase(ch); } else if (Character.isLowerCase(ch)) { buffer[i] = Character.toUpperCase(ch); } } return new String(buffer); }}下表为方法展示及描述
| 方法 | 描述 |
|---|---|
| isEmpty(String str) | 是否为空，空格字符为false |
| isNotEmpty(String str) | 是否为非空，空格字符为true |
| isBlank(String str) | 是否为空，空格字符为true |
| isNotBlank(String str) | 是否为非空，空格字符为false |
| trim(String str) | 去除字符串两端的控制符，空字符串、null 返回 null |
| trimToEmpty(String str) | 去除字符串两端的控制符，空字符串、null 返回"" |
| stripToNull(String str) | 去除字符串两端的空白符，空字符串、null 返回null |
| stripToEmpty(String str) | 去除字符串两端的空白符，空字符串、null 返回"" |
| strip(String str, String stripChars) | 去掉str两端的在stripChars中的字符 |
| StringUtils.strip(“000000134_76539000”,“0”)=“134_76539” | 去除某一个数 |
| stripStart (String str,String stripChars) | 去除str 前端在stripChars中的字符 |
| stripEnd (String str,String stripChars) | 去除str 后端在stripChars中的字符 |
| equals(String str1,String str2) | 比较两个字符串是否相等，如果两个均为空则认为相等 |
| indexOf(String str,char searchChar) | 返回searchChar 在字符串中第一次出现的位置，如果没找到则返回 -1，如果str 为null 或者 “”,也返回-1 |
| indexOf(String str,char searchChar,int startPos) | 返回字符searchChar从startPos开始在字符串str中第一次出现的位置。 |
| contains(String str,char searchChar) | str中是否包含字符searchChar，str为null 或者 searchChar为null,返回false 。 |
| containsIgnoreCase(String str,String searchStr) | str中是否包含字符searchChar，不区分大小写 |
| int indexOfAny(String str, char[] searchChars) | 找出字符数组searchChars中的字符第一次出现在字符串str中的位置。 如果字符数组中的字符都不在字符串中，则返回-1 ，如果字符串为null或""，则返回-1 |
| subString(String str,int start) | 从start 开始，包含start 那个字符，得到字符串str 的子串，如果start为负数，则从后面开始数起。如果str 为null 或者 “” 则返回其本身 |
| subStringBefore(String str,String separator) | 得到字符串separator第一次出现前的子串。不包含那个字符，如果str 为null 或者 “” 则返回其本身。 |
| subStringAfter(String str,String separator) | 得到字符串separator第一次出现后的子串，不包含那个字符，如果 str 为null，或者"",则返回其本身 |
| subString(String str,int start,int end) | 同上 |
| left(String str,int len) | 得到字符串str从左边数len长度的子串，如果str 为null 或者 “”,则返回其本身，如果len小于0，则返回"" |
| right(String str,int len) | 得到字符串str从右边数len长度的子串 |
| mid(String str,int pos,int len) | 得到字符串str从pos开始len长度的子串，pos小于0，则设为0。 |
| split(String str) | 把字符串拆分成一个字符串数组，用空白符 作为分隔符，字符串为null 返回null，字符串为"",返回空数组{} |
| split(String str,char c) | 按照 char c 拆分字符串 |
| join(Object[] arrey) | 把数组中的元素连接成一个字符串返回 |
| join(Object[] arrey,char c) | 把数组中的元素拼接成一个字符串返回，把分隔符 c 也带上 |
| deleteWhitespace(String str) | 删除字符串中的所有空白符，包括转义字符 |
| removeStart(String str,String remove) | 如果字符串str是以remove开始，则去掉这个开始，然后返回，否则返回原来的串 |
| removeEnd(String str,String remove) | 如果字符串str是以字符串remove结尾，则去掉这个结尾，然后返回，否则返回原来的串。 |
| remove(String str,char remove) | 去掉字符串str中所有包含remove的部分，然后返回 |
| replace(String str,String reql,String with) | 在字符串text中用with代替repl，替换所有 |
| overlay(String str,String new,int start,int end) | 用字符串new 覆盖字符串str从start 到 end 之间的串 |
| chop(String str) | 去掉字符串的最后一个字符,比如/r/n |
| repeat(String str,int repart) | 重复字符串repeat次 |
| rightPad(String str,int size,String padStr) | size长度的字符串，如果不够用padStr补齐 |
| leftPad(String str,int size,String padStr) | 同上 |
| center(String str,int size) | 产生一个字符串，长度等于size，str位于新串的中心 |
| swapCase(String str) | 字符串中的大写转小写，小写转换为大写 |
| replaceChars(String str,char old,char new) | 在字符串中 new 字符代替 old 字符 |
| replaceChars(String str, String searchChars, String replaceChars) | 这个有点特别，先看下面三个例子 |
| StringUtils.replaceChars(“asssdf”,“s”,“yyy”)) = “ayyydf” | 替换字符字符数组中所有的字符为 |
| StringUtils.contains("", “”) = true | 指定字符是否在字符串中出现过 |
转载地址：http://nbjk.baihongyu.com/