Class StrUtil

java.lang.Object
com.sure.tool.util.StrUtil

public class StrUtil extends Object
字符串工具类,参考 Hutool 的 StrUtil 设计。

提供判空、去空白、截取、拼接、格式化、驼峰转换等常用静态方法。

English: String utilities: emptiness checks, trimming, splitting, joining, casing and formatting.

Since:
0.1.0
Author:
suretool
  • Field Details

  • Method Details

    • isEmpty

      public static boolean isEmpty(CharSequence str)
      字符串是否为空:null 或长度为 0。
      Parameters:
      str - 字符串
      Returns:
      是否为空
    • isNotEmpty

      public static boolean isNotEmpty(CharSequence str)
      字符串是否非空。
      Parameters:
      str - 字符串
      Returns:
      是否非空
    • isBlank

      public static boolean isBlank(CharSequence str)
      字符串是否为空白:null、空串或全为空白字符。
      Parameters:
      str - 字符串
      Returns:
      是否空白
    • isNotBlank

      public static boolean isNotBlank(CharSequence str)
      字符串是否非空白。
      Parameters:
      str - 字符串
      Returns:
      是否非空白
    • hasBlank

      public static boolean hasBlank(CharSequence... strs)
      多个字符串中是否存在空白。
      Parameters:
      strs - 字符串数组
      Returns:
      是否存在空白
    • isAllBlank

      public static boolean isAllBlank(CharSequence... strs)
      多个字符串是否全部为空白。
      Parameters:
      strs - 字符串数组
      Returns:
      是否全部空白
    • hasEmpty

      public static boolean hasEmpty(CharSequence... strs)
      多个字符串中是否存在空串(null 或长度为 0)。
      Parameters:
      strs - 字符串数组
      Returns:
      是否存在空串
    • trim

      public static String trim(CharSequence str)
      去除字符串首尾空白(使用 String.trim() 语义)。
      Parameters:
      str - 字符串
      Returns:
      去空白后的字符串,null 时返回空串
    • trimToNull

      public static String trimToNull(CharSequence str)
      去除首尾空白,结果为空白时返回 null。
      Parameters:
      str - 字符串
      Returns:
      去空白后的字符串或 null
    • trimToEmpty

      public static String trimToEmpty(CharSequence str)
      去除首尾空白,结果为空白时返回空串。
      Parameters:
      str - 字符串
      Returns:
      去空白后的字符串
    • cleanBlank

      public static String cleanBlank(CharSequence str)
      去除字符串中所有空白字符(包括空格、制表符、换行等)。
      Parameters:
      str - 字符串
      Returns:
      去除所有空白后的字符串
    • equals

      public static boolean equals(CharSequence str1, CharSequence str2)
      比较两个字符串是否相等。
      Parameters:
      str1 - 字符串 1
      str2 - 字符串 2
      Returns:
      是否相等
    • equalsIgnoreCase

      public static boolean equalsIgnoreCase(CharSequence str1, CharSequence str2)
      忽略大小写比较两个字符串是否相等。
      Parameters:
      str1 - 字符串 1
      str2 - 字符串 2
      Returns:
      是否相等
    • contains

      public static boolean contains(CharSequence str, CharSequence searchStr)
      是否包含指定子串。
      Parameters:
      str - 原字符串
      searchStr - 要查找的子串
      Returns:
      是否包含
    • containsIgnoreCase

      public static boolean containsIgnoreCase(CharSequence str, CharSequence searchStr)
      忽略大小写是否包含指定子串。
      Parameters:
      str - 原字符串
      searchStr - 要查找的子串
      Returns:
      是否包含
    • containsAny

      public static boolean containsAny(CharSequence str, CharSequence... searchStr)
      是否包含任一指定子串。
      Parameters:
      str - 原字符串
      searchStr - 要查找的子串数组
      Returns:
      是否包含任意一个
    • startWith

      public static boolean startWith(CharSequence str, CharSequence prefix)
      是否以指定前缀开头。
      Parameters:
      str - 字符串
      prefix - 前缀
      Returns:
      是否以该前缀开头
    • startWithIgnoreCase

      public static boolean startWithIgnoreCase(CharSequence str, CharSequence prefix)
      忽略大小写是否以指定前缀开头。
      Parameters:
      str - 字符串
      prefix - 前缀
      Returns:
      是否以该前缀开头
    • endWith

      public static boolean endWith(CharSequence str, CharSequence suffix)
      是否以指定后缀结尾。
      Parameters:
      str - 字符串
      suffix - 后缀
      Returns:
      是否以该后缀结尾
    • endWithIgnoreCase

      public static boolean endWithIgnoreCase(CharSequence str, CharSequence suffix)
      忽略大小写是否以指定后缀结尾。
      Parameters:
      str - 字符串
      suffix - 后缀
      Returns:
      是否以该后缀结尾
    • sub

      public static String sub(CharSequence str, int fromIndex, int toIndex)
      安全截取字符串,支持负索引(从末尾倒数)。
      Parameters:
      str - 字符串
      fromIndex - 起始索引(含),负数表示从末尾倒数
      toIndex - 结束索引(不含),负数表示从末尾倒数
      Returns:
      截取结果,越界自动收敛
    • sub

      public static String sub(CharSequence str, int fromIndex)
      从起始索引截取到字符串末尾。
      Parameters:
      str - 字符串
      fromIndex - 起始索引(含)
      Returns:
      截取结果
    • removePrefix

      public static String removePrefix(CharSequence str, CharSequence prefix)
      去除字符串开头的指定前缀。
      Parameters:
      str - 字符串
      prefix - 前缀
      Returns:
      去除前缀后的字符串
    • removePrefixIgnoreCase

      public static String removePrefixIgnoreCase(CharSequence str, CharSequence prefix)
      忽略大小写去除字符串开头的指定前缀。
      Parameters:
      str - 字符串
      prefix - 前缀
      Returns:
      去除前缀后的字符串
    • removeSuffix

      public static String removeSuffix(CharSequence str, CharSequence suffix)
      去除字符串结尾的指定后缀。
      Parameters:
      str - 字符串
      suffix - 后缀
      Returns:
      去除后缀后的字符串
    • removeSuffixIgnoreCase

      public static String removeSuffixIgnoreCase(CharSequence str, CharSequence suffix)
      忽略大小写去除字符串结尾的指定后缀。
      Parameters:
      str - 字符串
      suffix - 后缀
      Returns:
      去除后缀后的字符串
    • replace

      public static String replace(CharSequence str, CharSequence searchStr, CharSequence replacement)
      替换字符串中的全部指定子串。
      Parameters:
      str - 原字符串
      searchStr - 被替换的子串
      replacement - 替换后的子串
      Returns:
      替换后的字符串
    • join

      public static String join(CharSequence delimiter, Object... objs)
      使用分隔符拼接对象数组。
      Parameters:
      delimiter - 分隔符
      objs - 对象数组
      Returns:
      拼接结果
    • join

      public static String join(CharSequence delimiter, Iterable<?> iterable)
      使用分隔符拼接可迭代集合。
      Parameters:
      delimiter - 分隔符
      iterable - 可迭代集合
      Returns:
      拼接结果
    • format

      public static String format(CharSequence template, Object... args)
      字符串格式化,使用一对花括号作为占位符,如 format("你好,&#123;&#125;", "世界")。
      Parameters:
      template - 模板
      args - 参数
      Returns:
      格式化结果
    • substitute

      public static String substitute(String template, Map<String,?> vars)
      模板变量替换(默认前缀 ${}、后缀 {@code }、转义符 $),委托 StrSubstitutor。

      支持默认值语法 ${key:-default};变量缺失保留占位符原样; 值为 null 渲染为空串;$$&#123; 输出字面 $&#123;。

      示例:

      String text = StrUtil.substitute("hi ${name}, env=${env:-dev}", Map.of("name", "sure"));
      // => "hi sure, env=dev"
      
      Parameters:
      template - 模板文本;为 null 时返回 null
      vars - 变量映射;为 null 时视为空映射
      Returns:
      替换结果
      Since:
      1.19.0
    • substitute

      public static String substitute(String template, Map<String,?> vars, String prefix, String suffix)
      模板变量替换(自定义定界符,默认转义符 $),委托 StrSubstitutor。

      示例:

      String text = StrUtil.substitute("&lt;%name%&gt; 你好", Map.of("name", "sure"), "&lt;%", "%&gt;");
      // => "sure 你好"
      
      Parameters:
      template - 模板文本;为 null 时返回 null
      vars - 变量映射;为 null 时视为空映射
      prefix - 占位符前缀
      suffix - 占位符后缀
      Returns:
      替换结果
      Throws:
      IllegalArgumentException - 前缀或后缀为 null 或空串时抛出
      Since:
      1.19.0
    • repeat

      public static String repeat(CharSequence str, int count)
      重复字符串指定次数。
      Parameters:
      str - 字符串
      count - 重复次数
      Returns:
      重复后的字符串
    • padPre

      public static String padPre(CharSequence str, int minLength, char padChar)
      字符串前补齐至指定长度。
      Parameters:
      str - 字符串
      minLength - 最小长度
      padChar - 补齐字符
      Returns:
      补齐后的字符串
    • padAfter

      public static String padAfter(CharSequence str, int minLength, char padChar)
      字符串后补齐至指定长度。
      Parameters:
      str - 字符串
      minLength - 最小长度
      padChar - 补齐字符
      Returns:
      补齐后的字符串
    • toCamelCase

      public static String toCamelCase(CharSequence name)
      下划线命名转驼峰命名,如 user_name → userName。
      Parameters:
      name - 下划线命名
      Returns:
      驼峰命名
    • toUnderlineCase

      public static String toUnderlineCase(CharSequence str)
      驼峰命名转下划线命名,如 userName → user_name。
      Parameters:
      str - 驼峰命名
      Returns:
      下划线命名
    • upperFirst

      public static String upperFirst(CharSequence str)
      首字母大写。
      Parameters:
      str - 字符串
      Returns:
      首字母大写后的字符串
    • lowerFirst

      public static String lowerFirst(CharSequence str)
      首字母小写。
      Parameters:
      str - 字符串
      Returns:
      首字母小写后的字符串
    • reverse

      public static String reverse(CharSequence str)
      反转字符串。
      Parameters:
      str - 字符串
      Returns:
      反转后的字符串
    • count

      public static int count(CharSequence str, char c)
      统计字符在字符串中出现的次数。
      Parameters:
      str - 字符串
      c - 字符
      Returns:
      出现次数
    • count

      public static int count(CharSequence str, CharSequence sub)
      统计子串在字符串中出现的次数。
      Parameters:
      str - 字符串
      sub - 子串
      Returns:
      出现次数
    • split

      public static String[] split(CharSequence str, char separator)
      按单个字符分割字符串。
      Parameters:
      str - 字符串
      separator - 分隔字符
      Returns:
      分割后的字符串数组
    • split

      public static String[] split(CharSequence str, String separator)
      按字符串分割(分隔符中的正则特殊字符会被转义)。
      Parameters:
      str - 字符串
      separator - 分隔符
      Returns:
      分割后的字符串数组
    • toString

      public static String toString(Object obj)
      对象转字符串,数组会展开输出,null 转为 "null"。
      Parameters:
      obj - 对象
      Returns:
      字符串
    • bytes

      public static byte[] bytes(CharSequence str, Charset charset)
      字符串转字节数组。
      Parameters:
      str - 字符串
      charset - 字符集
      Returns:
      字节数组
    • nullToEmpty

      public static String nullToEmpty(CharSequence str)
      null 转空串。
      Parameters:
      str - 字符串
      Returns:
      空串或原字符串
    • emptyToNull

      public static String emptyToNull(CharSequence str)
      空串转 null。
      Parameters:
      str - 字符串
      Returns:
      null 或原字符串
    • blankToDefault

      public static String blankToDefault(CharSequence str, String defaultStr)
      空白字符串使用默认值替换。
      Parameters:
      str - 字符串
      defaultStr - 默认值
      Returns:
      非空白时返回原串,否则返回默认值
    • emptyToDefault

      public static String emptyToDefault(CharSequence str, String defaultStr)
      空字符串使用默认值替换。
      Parameters:
      str - 字符串
      defaultStr - 默认值
      Returns:
      非空时返回原串,否则返回默认值
    • hide

      public static String hide(CharSequence str, int fromInclude, int toExclude, char maskChar)
      掩码:将 [fromInclude, toExclude) 区间字符替换为掩码符。
      Parameters:
      str - 原字符串
      fromInclude - 起始(含)
      toExclude - 结束(不含)
      maskChar - 掩码符
      Returns:
      掩码后字符串;null 返回 null
    • subBetween

      public static String subBetween(CharSequence str, CharSequence prefix, CharSequence suffix)
      取两标记之间的内容(第一个匹配)。
      Parameters:
      str - 原字符串
      prefix - 前标记
      suffix - 后标记
      Returns:
      中间内容;未匹配返回 null
    • isNumeric

      public static boolean isNumeric(CharSequence str)
      是否为数字字符串(允许正负号、小数点)。
      Parameters:
      str - 字符串
      Returns:
      是否数字
    • removeAll

      public static String removeAll(CharSequence str, CharSequence... values)
      移除所有指定子串。
      Parameters:
      str - 原字符串
      values - 要移除的子串
      Returns:
      移除后字符串;null 返回 null
    • indexOf

      public static int indexOf(CharSequence str, CharSequence search)
      查找子串首次出现位置。
      Parameters:
      str - 原字符串
      search - 子串
      Returns:
      位置;未找到或参数为空返回 -1
    • lastIndexOf

      public static int lastIndexOf(CharSequence str, CharSequence search)
      查找子串末次出现位置。
      Parameters:
      str - 原字符串
      search - 子串
      Returns:
      位置;未找到或参数为空返回 -1
    • startWithAny

      public static boolean startWithAny(CharSequence str, CharSequence... prefixes)
      是否以任一前缀开头。
      Parameters:
      str - 字符串
      prefixes - 前缀组
      Returns:
      是否命中任一
    • endWithAny

      public static boolean endWithAny(CharSequence str, CharSequence... suffixes)
      是否以任一后缀结尾。
      Parameters:
      str - 字符串
      suffixes - 后缀组
      Returns:
      是否命中任一
    • splitToIntArray

      public static int[] splitToIntArray(String str)
      分隔为 int 数组(空白分隔),非法元素按 0 处理。
      Parameters:
      str - 数字字符串
      Returns:
      int 数组
    • splitToLongArray

      public static long[] splitToLongArray(String str)
      分隔为 long 数组(空白分隔),非法元素按 0 处理。
      Parameters:
      str - 数字字符串
      Returns:
      long 数组
    • subBetweenAll

      public static List<String> subBetweenAll(String str, String prefix, String suffix)
      提取所有两两之间的内容。
      Parameters:
      str - 字符串
      prefix - 前缀
      suffix - 后缀
      Returns:
      提取结果列表
    • splitToDoubleArray

      public static double[] splitToDoubleArray(String str)
      分隔为 double 数组(空白分隔),非法元素按 0 处理。
      Parameters:
      str - 数字字符串
      Returns:
      double 数组
    • removePrefix

      public static String removePrefix(String str, String prefix)
      去除指定前缀(无前缀则原样返回)。
      Parameters:
      str - 字符串
      prefix - 前缀
      Returns:
      结果
    • removeSuffix

      public static String removeSuffix(String str, String suffix)
      去除指定后缀(无后缀则原样返回)。
      Parameters:
      str - 字符串
      suffix - 后缀
      Returns:
      结果
    • subSuf

      public static String subSuf(String str, int len)
      截取尾部 n 个字符。
      Parameters:
      str - 字符串
      len - 长度
      Returns:
      尾部字符串
    • subPre

      public static String subPre(String str, int len)
      截取头部 n 个字符。
      Parameters:
      str - 字符串
      len - 长度
      Returns:
      头部字符串
    • splitTrim

      public static String[] splitTrim(String str, String separator)
      按分隔符拆分并去除每个元素首尾空白(保留空元素)。
      Parameters:
      str - 字符串
      separator - 分隔符
      Returns:
      拆分结果
    • blankToDefault

      public static String blankToDefault(String str, String defaultValue)
      空字符串(含空白)返回默认值,否则原样返回。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      结果
    • isUpperCase

      public static boolean isUpperCase(String str)
      判断是否全部为大写字母(忽略非字母字符)。
      Parameters:
      str - 字符串
      Returns:
      是否全大写;空串返回 false
    • isLowerCase

      public static boolean isLowerCase(String str)
      判断是否全部为小写字母(忽略非字母字符)。
      Parameters:
      str - 字符串
      Returns:
      是否全小写;空串返回 false
    • fillBefore

      public static String fillBefore(String str, int minLen, char padChar)
      前补位:字符串不足指定长度时在前面填充字符。
      Parameters:
      str - 字符串
      minLen - 最小长度
      padChar - 填充字符
      Returns:
      补位后的字符串
    • fillAfter

      public static String fillAfter(String str, int minLen, char padChar)
      后补位:字符串不足指定长度时在后面填充字符。
      Parameters:
      str - 字符串
      minLen - 最小长度
      padChar - 填充字符
      Returns:
      补位后的字符串
    • toUnicode

      public static String toUnicode(String str)
      转 Unicode 字符串(中文转 \uXXXX,ASCII 保留)。
      Parameters:
      str - 字符串
      Returns:
      Unicode 表示
    • maxLength

      public static String maxLength(String str, int maxLength)
      限制字符串最大长度,超出截断并追加省略号。
      Parameters:
      str - 字符串
      maxLength - 最大长度(含省略号)
      Returns:
      截断后的字符串
    • strip

      public static String strip(String str, char stripChar)
      去除字符串首尾的指定字符。
      Parameters:
      str - 字符串
      stripChar - 要去除的字符
      Returns:
      处理后的字符串
    • strip

      public static String strip(String str)
      去除字符串首尾的空白字符。
      Parameters:
      str - 字符串
      Returns:
      处理后的字符串
    • center

      public static String center(String str, int size, char fillChar)
      将字符串居中对齐,两侧以指定字符填充。
      Parameters:
      str - 字符串
      size - 目标长度
      fillChar - 填充字符
      Returns:
      居中对齐后的字符串
    • center

      public static String center(String str, int size, String fill)
      将字符串居中对齐,两侧以指定字符串填充。
      Parameters:
      str - 字符串
      size - 目标长度
      fill - 填充串
      Returns:
      居中对齐后的字符串
    • firstNonBlank

      public static String firstNonBlank(String... values)
      返回第一个非空白字符串。
      Parameters:
      values - 候选字符串
      Returns:
      第一个非空白值;全为空返回 null
    • concat

      public static String concat(String... values)
      拼接多个字符串为一个字符串。
      Parameters:
      values - 字符串数组
      Returns:
      拼接结果
    • swapCase

      public static String swapCase(String str)
      交换字符串中字母的大小写。
      Parameters:
      str - 字符串
      Returns:
      大小写互换后的字符串
    • isAllNotBlank

      public static boolean isAllNotBlank(CharSequence... strs)
      判断字符串数组中是否全部非空白。
      Parameters:
      strs - 字符串数组
      Returns:
      是否全部非空白
    • isAllEmpty

      public static boolean isAllEmpty(CharSequence... strs)
      判断字符串数组中是否全部为空。
      Parameters:
      strs - 字符串数组
      Returns:
      是否全部为空
    • replace

      public static String replace(CharSequence str, int beginIndex, int endIndex, CharSequence replacement)
      替换字符串中指定区间(含 begin,不含 end)的内容。
      Parameters:
      str - 字符串
      beginIndex - 起始索引(含)
      endIndex - 结束索引(不含)
      replacement - 替换串
      Returns:
      替换后的字符串
    • containsAnyIgnoreCase

      public static boolean containsAnyIgnoreCase(CharSequence str, CharSequence... searchStrs)
      忽略大小写判断字符串是否包含任意给定子串。
      Parameters:
      str - 字符串
      searchStrs - 子串列表
      Returns:
      是否包含任意一个
    • replaceIgnoreCase

      public static String replaceIgnoreCase(CharSequence str, CharSequence searchStr, CharSequence replacement)
      忽略大小写替换所有匹配子串。
      Parameters:
      str - 字符串
      searchStr - 查找子串
      replacement - 替换串
      Returns:
      替换后的字符串
    • isWrap

      public static boolean isWrap(CharSequence str, String prefix, String suffix)
      判断字符串是否被指定前后缀包裹。

      例如 isWrap("[abc]", "[", "]") 返回 true。

      Parameters:
      str - 字符串
      prefix - 前缀
      suffix - 后缀
      Returns:
      是否被包裹
    • wrap

      public static String wrap(CharSequence str, CharSequence prefix, CharSequence suffix)
      使用指定前后缀包裹字符串。
      Parameters:
      str - 字符串
      prefix - 前缀
      suffix - 后缀
      Returns:
      包裹后的字符串;str 为 null 时返回 null
    • unWrap

      public static String unWrap(CharSequence str, CharSequence prefix, CharSequence suffix)
      去除字符串包裹(仅当首尾实际匹配时去除,否则原样返回)。
      Parameters:
      str - 字符串
      prefix - 前缀
      suffix - 后缀
      Returns:
      去除包裹后的字符串;str 为 null 时返回 null
    • equalsAny

      public static boolean equalsAny(CharSequence str, CharSequence... values)
      判断字符串是否等于给定值中的任意一个。
      Parameters:
      str - 字符串
      values - 候选值
      Returns:
      是否等于任意一个
    • equalsAnyIgnoreCase

      public static boolean equalsAnyIgnoreCase(CharSequence str, CharSequence... values)
      忽略大小写判断字符串是否等于给定值中的任意一个。
      Parameters:
      str - 字符串
      values - 候选值
      Returns:
      是否等于任意一个
    • totalLength

      public static int totalLength(CharSequence... strs)
      计算多个字符串的总长度(null 视为空串)。
      Parameters:
      strs - 字符串数组
      Returns:
      总长度
    • subBefore

      public static String subBefore(String str, String separator, boolean isLastMatch)
      截取指定分隔符之前的子串。
      Parameters:
      str - 原字符串
      separator - 分隔符
      isLastMatch - 是否匹配最后一个分隔符
      Returns:
      分隔符之前的子串;str 为 null 返回 null;无分隔符返回原串
      Since:
      1.0.1
    • subAfter

      public static String subAfter(String str, String separator, boolean isLastMatch)
      截取指定分隔符之后的子串。
      Parameters:
      str - 原字符串
      separator - 分隔符
      isLastMatch - 是否匹配最后一个分隔符
      Returns:
      分隔符之后的子串;str 为 null 返回 null;无分隔符返回原串
      Since:
      1.0.1
    • trimStart

      public static String trimStart(String str)
      去除字符串首部空白字符。
      Parameters:
      str - 原字符串
      Returns:
      去除首部空白后的字符串;null 返回 null
      Since:
      1.0.1
    • trimEnd

      public static String trimEnd(String str)
      去除字符串尾部空白字符。
      Parameters:
      str - 原字符串
      Returns:
      去除尾部空白后的字符串;null 返回 null
      Since:
      1.0.1
    • surround

      public static String surround(CharSequence str, CharSequence wrap)
      用指定包裹字符串将目标字符串首尾包裹(如用引号包裹)。
      Parameters:
      str - 目标字符串
      wrap - 包裹字符串
      Returns:
      包裹后的字符串;str 为 null 返回 null
      Since:
      1.0.1
    • abbreviate

      public static String abbreviate(CharSequence str, int maxWidth)
      截断字符串:超过 maxWidth 时保留前 maxWidth-3 个字符并以 ... 结尾。
      Parameters:
      str - 原字符串
      maxWidth - 最大宽度,小于 4 视为 4
      Returns:
      截断后的字符串;str 为 null 返回 null
    • abbreviate

      public static String abbreviate(CharSequence str, int offset, int maxWidth)
      截断字符串:从指定偏移开始,超过 maxWidth 时以 ... 结尾。
      Parameters:
      str - 原字符串
      offset - 起始偏移(越界自动归位)
      maxWidth - 最大宽度,小于 4 视为 4
      Returns:
      截断后的字符串;str 为 null 返回 null
    • abbreviateMiddle

      public static String abbreviateMiddle(CharSequence str, String middle, int length)
      中间省略:保留首尾字符,中间以指定省略串连接(参考 commons-lang StringUtils.abbreviateMiddle)。
      Parameters:
      str - 原字符串
      middle - 省略串(如 "...")
      length - 目标总长度(含省略串),小于 middle 长度时直接返回 middle
      Returns:
      中间省略后的字符串;str 为 null 返回 null
    • substringBetween

      public static String substringBetween(CharSequence str, CharSequence tag)
      取标签之间的文本(单标签,首次匹配):形如 <a>text</a> 取 text。
      Parameters:
      str - 原字符串
      tag - 标签文本
      Returns:
      标签间文本;无匹配返回 null
    • substringBetween

      public static String substringBetween(CharSequence str, CharSequence open, CharSequence close)
      取开始与结束标签之间的文本(首次匹配)。
      Parameters:
      str - 原字符串
      open - 开始标签
      close - 结束标签
      Returns:
      标签间文本;无匹配返回 null
    • difference

      public static String difference(CharSequence str1, CharSequence str2)
      返回首个差异位置起的子串(参考 commons-lang StringUtils.difference)。
      Parameters:
      str1 - 字符串一
      str2 - 字符串二
      Returns:
      从首个不同字符到 str2 末尾的子串;str1 为 null 返回 str2
    • indexOfIgnoreCase

      public static int indexOfIgnoreCase(CharSequence str, CharSequence search, int from)
      忽略大小写查找子串位置。
      Parameters:
      str - 原字符串
      search - 查找目标
      from - 起始索引(负数按 0)
      Returns:
      首次命中的索引;str 为 null 返回 -1
    • swapCase

      public static String swapCase(CharSequence str)
      大小写互换:大写转小写、小写转大写(参考 commons-lang StringUtils.swapCase)。
      Parameters:
      str - 原字符串
      Returns:
      互换后的字符串;str 为 null 返回 null
    • normalizeSpace

      public static String normalizeSpace(CharSequence str)
      空白规范化:首尾去空白,内部连续空白(含换行制表)压缩为单个空格。
      Parameters:
      str - 原字符串
      Returns:
      规范化结果;str 为 null 返回 null
    • getCommonPrefix

      public static String getCommonPrefix(CharSequence... strs)
      多个字符串的公共前缀(参考 commons-lang StringUtils.getCommonPrefix)。
      Parameters:
      strs - 字符串数组
      Returns:
      公共前缀;数组为空或含 null 返回空串
    • rotate

      public static String rotate(CharSequence str, int shift)
      循环移位:正数右移、负数左移(参考 commons-lang StringUtils.rotate)。
      Parameters:
      str - 原字符串
      shift - 移位位数(可为负)
      Returns:
      移位后的字符串;str 为 null 返回 null
    • isAlpha

      public static boolean isAlpha(CharSequence str)
      是否为纯字母(仅含字母字符)。

      示例:StrUtil.isAlpha("abc") -> true,StrUtil.isAlpha("a1") -> false。

      Parameters:
      str - 字符串,可为 null
      Returns:
      全为字母返回 true;null 或空串返回 false
    • isAlphanumeric

      public static boolean isAlphanumeric(CharSequence str)
      是否仅含字母或数字。

      示例:StrUtil.isAlphanumeric("abc123") -> true。

      Parameters:
      str - 字符串,可为 null
      Returns:
      全为字母或数字返回 true;null 或空串返回 false
    • isNumericSpace

      public static boolean isNumericSpace(CharSequence str)
      是否仅含数字或空格。

      示例:StrUtil.isNumericSpace("12 345") -> true。

      Parameters:
      str - 字符串,可为 null
      Returns:
      全为数字或空格返回 true;null 或空串返回 false
    • isAsciiPrintable

      public static boolean isAsciiPrintable(CharSequence str)
      是否全为可打印 ASCII 字符(码位 32–126,含空格)。

      示例:StrUtil.isAsciiPrintable("Hello!") -> true。

      Parameters:
      str - 字符串,可为 null
      Returns:
      全为可打印 ASCII 返回 true;null 或空串返回 false
    • containsWhitespace

      public static boolean containsWhitespace(CharSequence str)
      是否包含任意空白字符(Character.isWhitespace(char))。

      示例:StrUtil.containsWhitespace("a b") -> true。

      Parameters:
      str - 字符串,可为 null
      Returns:
      含空白返回 true;null 或空串返回 false
    • removeWhitespace

      public static String removeWhitespace(CharSequence str)
      移除字符串中的全部空白字符。

      示例:StrUtil.removeWhitespace(" a b ") -> "ab"。

      Parameters:
      str - 字符串,可为 null
      Returns:
      去空白后的字符串;null 返回 null
    • indexOfAny

      public static int indexOfAny(CharSequence str, CharSequence... searchStrs)
      返回任一给定子串在原字符串中最早出现的位置。

      示例:StrUtil.indexOfAny("hello world", "world", "lo") -> 3。

      Parameters:
      str - 原字符串,可为 null
      searchStrs - 待查找子串集合
      Returns:
      最早出现位置;未找到或参数为 null 返回 -1
    • lastIndexOfAny

      public static int lastIndexOfAny(CharSequence str, CharSequence... searchStrs)
      返回任一给定子串在原字符串中最后出现的位置(以子串结尾为参照)。

      示例:StrUtil.lastIndexOfAny("hello lo", "lo", "ell") -> 7。

      Parameters:
      str - 原字符串,可为 null
      searchStrs - 待查找子串集合
      Returns:
      最后出现位置;未找到或参数为 null 返回 -1
    • replaceOnce

      public static String replaceOnce(CharSequence str, CharSequence searchStr, CharSequence replacement)
      仅替换第一次出现的搜索子串。

      示例:StrUtil.replaceOnce("aa-bb-cc", "-", "+") -> "aa+bb-cc"。

      Parameters:
      str - 原字符串,可为 null
      searchStr - 搜索子串,可为 null
      replacement - 替换子串,可为 null
      Returns:
      替换结果;str 为 null 返回 null
    • removeSurrounding

      public static String removeSurrounding(CharSequence str, CharSequence wrap)
      当字符串以给定前后缀同时包裹时,一次性剥去首尾(前后缀相同字符串)。

      示例:StrUtil.removeSurrounding("\"abc\"", "\"") -> "abc"。

      Parameters:
      str - 字符串,可为 null
      wrap - 同时作为前缀与后缀的字符串
      Returns:
      剥去包裹后的字符串;null 返回 null
    • removeSurrounding

      public static String removeSurrounding(CharSequence str, CharSequence prefix, CharSequence suffix)
      当字符串以给定前后缀同时包裹时,一次性剥去首尾。

      示例:StrUtil.removeSurrounding("[abc]", "[", "]") -> "abc"。

      Parameters:
      str - 字符串,可为 null
      prefix - 前缀
      suffix - 后缀
      Returns:
      剥去包裹后的字符串;str 为 null 返回 null
    • removeSurroundingIgnoreCase

      public static String removeSurroundingIgnoreCase(CharSequence str, CharSequence wrap)
      忽略大小写:当字符串以给定前后缀同时包裹时,一次性剥去首尾(前后缀相同字符串)。
      Parameters:
      str - 字符串,可为 null
      wrap - 同时作为前缀与后缀的字符串
      Returns:
      剥去包裹后的字符串;null 返回 null
    • removeSurroundingIgnoreCase

      public static String removeSurroundingIgnoreCase(CharSequence str, CharSequence prefix, CharSequence suffix)
      忽略大小写:当字符串以给定前后缀同时包裹时,一次性剥去首尾。

      示例:StrUtil.removeSurroundingIgnoreCase("[ABC]", "[", "]") -> "ABC"。

      Parameters:
      str - 字符串,可为 null
      prefix - 前缀
      suffix - 后缀
      Returns:
      剥去包裹后的字符串;str 为 null 返回 null
    • truncate

      public static String truncate(CharSequence str, int maxWidth)
      精确截断字符串:长度超过 maxWidth 时截取前 maxWidth 个字符(不附加省略号)。

      语义对齐 Commons StringUtils.truncate,与 Hutool maxLength(保留省略号)不同: 示例:StrUtil.truncate("hello world", 5) -> "hello"。

      Parameters:
      str - 字符串,可为 null
      maxWidth - 最大长度,负数抛 IllegalArgumentException
      Returns:
      截断后的字符串;null 返回 null
    • splitPreserveAllTokens

      public static String[] splitPreserveAllTokens(CharSequence str, char separatorChar)
      按分隔字符分割并保留全部空 token(连续分隔符、首尾分隔符产生的空串均保留)。

      示例:StrUtil.splitPreserveAllTokens(",a,,b,", ',') -> ["", "a", "", "b", ""]。

      Parameters:
      str - 字符串,可为 null
      separatorChar - 分隔字符
      Returns:
      分割结果数组;null 返回 null
    • stripStart

      public static String stripStart(String str, String stripChars)
      剥离开头出现的字符集合字符(stripChars 为 null 时剥离空白)。

      示例:StrUtil.stripStart("__abc__", "_") -> "abc__"。

      Parameters:
      str - 字符串,可为 null
      stripChars - 待剥离的字符集合,null 表示剥离空白
      Returns:
      剥离后的字符串;null 返回 null
    • stripEnd

      public static String stripEnd(String str, String stripChars)
      剥离结尾出现的字符集合字符(stripChars 为 null 时剥离空白)。

      示例:StrUtil.stripEnd("__abc__", "_") -> "__abc"。

      Parameters:
      str - 字符串,可为 null
      stripChars - 待剥离的字符集合,null 表示剥离空白
      Returns:
      剥离后的字符串;null 返回 null