StringUtil (ready-x 3.5.1 API)

java.lang.Object
- me.codeplayer.util.StringUtil

```
public abstract class StringUtil
extends Object
```
用于对字符串类型的数据进行常用处理操作的工具类

作者:

Ready

字段概要

字段
限定符和类型字段和说明

protected static char[] digits
用于在2-16进制之间进行转换的映射字符数组

字段
限定符和类型	字段和说明
`protected static char[]`	`digits` 用于在2-16进制之间进行转换的映射字符数组

构造器概要

构造器
构造器和说明

StringUtil()

构造器
构造器和说明
`StringUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static StringBuilder`	`append(StringBuilder sb, String... strs)` 拼接多个字符串（忽略其中为 null 的参数）
`static String`	`capitalize(String str)` 将字符串的首字母大写
`static String`	`concat(String a, String b)` 拼接两个字符串（忽略其中为 null 的参数）
`static String`	`concat(String a, String b, String c)` 拼接多个字符串（忽略其中为 null 的参数）
`static String`	`concats(String... strs)` 拼接多个字符串（忽略其中为 null 的参数）
`static boolean`	`containsWord(String container, String searchedWord, String seperatorChars)` 检测指定字符串中是否存在指定的单词该方法采用快速模式，对于类似 `containsWord("abc123,123", "123", ",")` 等特殊情况无法保证100%可靠；如果想要保证可靠性，建议使用 `containsWord(String, String, String, boolean)`
`static boolean`	`containsWord(String container, String search, String seperatorChars, boolean fastMode)` 检测指定字符串中是否存在指定的单词
`static String`	`convertCharset(String str, Charset originalCharset, Charset targetCharset)` 将字符串从指定字符集编码转换为目标字符集编码
`static String`	`convertCharsetForURI(String str, Charset targetCharset)` 将指定的URI参数字符串转换为目标字符集编码本方法实际上是将字符串从ISO-8859-1编码转换为指定的目标编码
`static String`	`decapitalize(String str)` 将字符串的首字母小写
`static boolean`	`endsWith(String str, char lastChar)` 判断指定字符串是否以指定的单个字符结尾
`static int[]`	`ensureRangeSafe(int beginIndex, int endIndex, int length)` 确保起始和结束索引的范围边界安全，并返回范围安全的 [开始索引, 结束索引] 数组如果索引参数为负，自动加上 `length`，如果处理后的 `beginIndex > endIndex`，则自动对调位置方法起始索引或结束索引超出合理边界，方法内会尽可能地根据 `length` 进行调整： 1、如果 `beginIndex < -length` ，则 `beginIndex = 0` 2、如果 `endIndex > length` ，则 `endIndex = length`
`static StringBuilder`	`escape(StringBuilder sb, String str, char escapeChar, char[] escapedChars)` 使用转义字符转义字符串中指定的字符
`static String`	`escape(String str, char escapeChar, char[] escapedChars)` 使用转义字符转义字符串中指定的字符
`static String`	`escapeSQLLike(String likeStr)` 将指定的用于LIKE语句的字符串转义，以防止SQL语句注入该方法默认使用'\'进行转义操作
`static String`	`escapeSQLLike(String likeStr, boolean appendLikeWildcard)` 将指定的用于LIKE语句的字符串转义，以防止SQL语句注入该方法默认使用'\'进行转义操作
`static String`	`escapeSQLLike(String likeStr, boolean appendWildcardAtStart, boolean appendWildcardAtEnd)` 使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
`static StringBuilder`	`escapeSQLLike(StringBuilder sb, String likeStr, char escapeChar, boolean appendWildcardAtStart, boolean appendWildcardAtEnd)` 使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
`static String`	`escapeSQLLike(String likeStr, char escapeChar, boolean appendWildcardAtBoth)` 使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
`static String`	`escapeSQLLike(String likeStr, char escapeChar, boolean appendWildcardAtStart, boolean appendWildcardAtEnd)` 使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
`static String`	`fastUnicode(String str)` 获取指定字符串的Unicode编码，例如："中国"将返回"中国" 此方法返回的编码中，字母均采用大写形式，此外，由于编码的长度是已知的，本方法采用char数组作为字符容器，省略了StringBuilder追加时的长度判断以及封装损耗，性能更加优异
`static StringBuilder`	`getBuilder(int extra, CharSequence s1)` 根据将要追加的多个字符序列获得适当初始容量的 `StringBuilder`
`static StringBuilder`	`getBuilder(int extra, CharSequence s1, CharSequence s2)` 根据将要追加的多个字符序列获得适当初始容量的 `StringBuilder`
`static StringBuilder`	`getBuilder(int extra, CharSequence s1, CharSequence s2, CharSequence s3)` 根据将要追加的多个字符序列获得适当初始容量的 `StringBuilder`
`static StringBuilder`	`getBuilder(int extra, CharSequence s1, CharSequence s2, CharSequence s3, CharSequence s4)` 根据将要追加的多个字符序列获得适当初始容量的 `StringBuilder`
`static StringBuilder`	`getBuilder(int size, int shift)` 根据每个元素的平均大小和元素的格式创建一个适用于其容量的StringBuilder 内部采用`length << shift` 来获取设置初始容量并且生成的StringBuilder的最小容量为16(StringBuilder的默认容量)
`static boolean`	`hasBlank(Object... values)` 判断指定数组中是否为空的值(null、空字符串、空格字符串),如果是，将返回true 本方法接受多个参数，如果其中有任意一个为空，就返回true 本方法会去除两边的空格后再判断如果指定的key不存在也返回true
`static boolean`	`hasEmpty(Object... values)` 判断指定数组中是否存在为空的值(null、空字符串),如果是将返回true 本方法接受多个参数，如果其中有任意一个为空，就返回true 如果指定的key不存在也返回true
`static StringBuilder`	`initBuilder(StringBuilder sb, int appendLength)` 初始化一个还可以添加 `appendLength` 个字符的 StringBuilder
`static boolean`	`isAnyNotEmpty(CharSequence... css)` 判断指定的字符序列数组是否存在不为空的元素如果数组中存在不为null、空字符串的元素，则返回true，否则返回false
`static boolean`	`isBlank(CharSequence str)` 判断指定的字符串是否为空如果字符串为null、空字符串、空格字符串，则返回true 注意：本方法会先去除字符串两边的空格，再判断
`static boolean`	`isBlank(Object obj)` 判断指定的对象是否为空如果对象(或其 toString() 返回值)为null、空字符串、空格字符串，则返回true 注意：本方法会先去除字符串两边的空格，再判断
`static boolean`	`isEmpty(CharSequence cs)` 判断指定的字符串是否为空如果字符串为null、空字符串，则返回true，否则返回false 注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用 `isBlank(CharSequence)` 方法
`static boolean`	`isEmpty(Object obj)` 判断指定的对象是否为空如果对象(或其 toString() 返回值)为null、空字符串，则返回true 注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用isBlank(Object obj)方法
`static String`	`leftPad(String str, char ch, int maxLength)` 如果字符串不足指定位数，则在前面补充指定的字符，直到指定位数如果字符串=null，则返回空字符串"" 如果字符串位数大于指定位数，则返回原字符串
`static int`	`length(CharSequence cs)` 获取指定字符序列的字符长度
`static String`	`limitChars(String str, int maxLength)` 如果指定字符串超过限制长度`maxLength`,则返回限制长度前面的部分字符串如果指定字符串==null，则返回空字符串如果字符串超出指定长度，则返回maxLength前面的部分，并在末尾加上后缀“...”
`static String`	`limitChars(String str, int maxLength, String suffix)` 如果指定字符串超过限制长度`maxLength`,则返回限制长度前面的部分字符串如果指定字符串==null，则返回空字符串如果字符串超出指定长度，则返回maxLength前面的部分，并在末尾加上后缀`suffix`
`static boolean`	`notBlank(CharSequence cs)` 判断指定的字符串是否不为空如果字符串不为null、空字符串、空格字符串，则返回true，否则返回false 注意：本方法会先去除字符串两边的空格，再判断
`static boolean`	`notBlank(Object obj)` 判断指定的对象是否为空如果对象(或其 toString() 返回值)不为null、空字符串、空格字符串，则返回true，否则返回false 注意：本方法会先去除字符串两边的空格，再判断
`static boolean`	`notEmpty(CharSequence cs)` 判断指定的字符串是否不为空如果指定字符串不为null、空字符串，则返回true，否则返回false 注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用 `notBlank(CharSequence)` 方法
`static boolean`	`notEmpty(Object obj)` 判断指定的对象是否不为空如果对象(或其 toString() 返回值)不为null、空字符串，则返回true，否则返回false 注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用`isBlank(Object obj)`方法
`static String`	`nullSafeGet(CharSequence cs)` 安全地获取指定字符序列中的字符串
`static String`	`nullSafeGet(Supplier<? extends CharSequence> msgSupplier)` 安全地执行指定的字符串懒加载表达式，并返回对应的字符串
`static String`	`replaceChar(String str, int charIndex, CharConverter converter)` 替换字符串中指定位置的字符，并返回替换后的结果
`static String`	`replaceChars(String str, char ch, int beginIndex)` 将指定字符串的 `beginIndex` 到末尾之间的字符全部替换为字符 `ch`
`static String`	`replaceChars(String str, char ch, int beginIndex, int endIndex)` 将指定字符串的 `beginIndex` 到 `endIndex` (不包括 `endIndex` ) 之间的字符全部替换为字符 `ch`
`static String`	`replaceSubstring(String str, String replacement, int beginIndex)` 将指定字符串的 `beginIndex` 及其后的子字符串全部替换为指定的字符串 `replacement`
`static String`	`replaceSubstring(String str, String replacement, int beginIndex, int endIndex)` 将指定字符串的 `beginIndex` 到 `endIndex` (不包括 `endIndex` ) 之间的子字符串全部替换为指定的字符串 `replacement`
`static String`	`reverse(CharSequence str)` 颠倒(反转)字符串的字符顺序，并返回颠倒后的字符串如果字符串为null，则返回空字符串""
`static String`	`rightPad(String str, char ch, int maxLength)` 如果字符串不足指定位数，则在后面补充指定的字符，直到指定位数如果字符串=null，则返回空字符串"" 如果字符串位数大于指定位数，则返回原字符串
`static <T> List<T>`	`split(String str, String sep, Function<? super String,T> mapper, boolean ignoreNull)` 将以指定分隔字符分隔字符串，并将拆分后的每个片段文本使用指定的 `mapper` 进行转换，并返回转换后的元素集合
`static <T> List<T>`	`split(String str, String sep, Function<String,T> mapper)` 将以指定分隔字符分隔字符串，并将拆分后的每个片段文本使用指定的 `mapper` 进行转换，并返回转换后的元素集合
`static boolean`	`startsWith(String str, char firstChar)` 判断指定字符串是否以指定的单个字符开头
`static String`	`toString(Object obj)` 以String的形式返回对象值，如果对象为null，则返回""
`static String`	`toString(Object obj, String defaultValIfNull)` 以String的形式返回对象值，如果对象为null，则返回""
`static String`	`trim(Object obj)` 以去除两边空格的String形式返回对象值，如果对象为null，则返回""
`static String`	`trim(String str)` 去除字符串两侧的空白字符如果为null则返回空字符串""
`static String`	`trim4Html(Object obj)` 以String的形式返回对象值，如果对象为null或空格字符串，则返回" "
`static StringBuilder`	`unescape(StringBuilder sb, String escapedStr, char escapeChar, char[] escapedChars)` 解除对使用 `escape(StringBuilder, String, char, char[])` 方法转义后的字符串的转义
`static String`	`unescape(String escapedStr, char escapeChar, char[] escapedChars)` 解除对使用 `escape(StringBuilder, String, char, char[])` 方法转义后的字符串的转义
`static String`	`unicode(String src)` 获取指定字符串的Unicode编码，例如：“中国”将返回“中国” 此方法返回的编码中，字母均采用大写形式，此外，本方法采用 `StringBuilder` 作为字符容器
`static String`	`zeroFill(String str, int maxLength)` 如果字符串不足指定位数，则前面补0，直到指定位数如果字符串=null，则返回空字符串"" 如果字符串位数大于指定位数，则返回原字符串

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - digits
```
protected static final char[] digits
```
    用于在2-16进制之间进行转换的映射字符数组
- 构造器详细资料
  - StringUtil
```
public StringUtil()
```
- 方法详细资料
  - unicode
```
public static String unicode(String src)
```
    获取指定字符串的Unicode编码，例如：“中国”将返回“中国”
    此方法返回的编码中，字母均采用大写形式，此外，本方法采用 StringBuilder 作为字符容器
    
    参数:
    
    src - 指定字符串不能为 null，否则将引发空指针异常
    
    从以下版本开始:
    
    0.0.1
  - fastUnicode
```
public static String fastUnicode(String str)
```
    获取指定字符串的Unicode编码，例如："中国"将返回"中国"
    此方法返回的编码中，字母均采用大写形式，此外，由于编码的长度是已知的，本方法采用char数组作为字符容器，省略了StringBuilder追加时的长度判断以及封装损耗，性能更加优异
    
    参数:
    
    str - 指定字符串不能为null，否则将引发空指针异常
    
    从以下版本开始:
    
    0.0.1
  - getBuilder
```
public static StringBuilder getBuilder(int size,
                                       int shift)
```
    根据每个元素的平均大小和元素的格式创建一个适用于其容量的StringBuilder
    内部采用length << shift 来获取设置初始容量
    并且生成的StringBuilder的最小容量为16(StringBuilder的默认容量)
    
    参数:
    
    size - 元素个数
    
    shift - 每个元素参与拼接的平均字符数相对于2的位移量
    
    从以下版本开始:
    
    0.0.1
  - length
```
public static int length(CharSequence cs)
```
    获取指定字符序列的字符长度
    
    返回:
    
    对应的字符长度，如果 cs 为 null，则返回 0
    
    从以下版本开始:
    
    0.4.2
  - getBuilder
```
public static StringBuilder getBuilder(int extra,
                                       CharSequence s1,
                                       CharSequence s2,
                                       CharSequence s3,
                                       CharSequence s4)
```
    根据将要追加的多个字符序列获得适当初始容量的 StringBuilder
    
    参数:
    
    extra - 除指定的字符序列外应额外预留的字符容量
    
    从以下版本开始:
    
    0.4.2
  - getBuilder
```
public static StringBuilder getBuilder(int extra,
                                       CharSequence s1,
                                       CharSequence s2,
                                       CharSequence s3)
```
    根据将要追加的多个字符序列获得适当初始容量的 StringBuilder
    
    参数:
    
    extra - 除指定的字符序列外应额外预留的字符容量
    
    从以下版本开始:
    
    0.4.2
  - getBuilder
```
public static StringBuilder getBuilder(int extra,
                                       CharSequence s1,
                                       CharSequence s2)
```
    根据将要追加的多个字符序列获得适当初始容量的 StringBuilder
    
    参数:
    
    extra - 除指定的字符序列外应额外预留的字符容量
    
    从以下版本开始:
    
    0.4.2
  - getBuilder
```
public static StringBuilder getBuilder(int extra,
                                       CharSequence s1)
```
    根据将要追加的多个字符序列获得适当初始容量的 StringBuilder
    
    参数:
    
    extra - 除指定的字符序列外应额外预留的字符容量
    
    从以下版本开始:
    
    0.4.2
  - concat
```
@Nullable
public static String concat(@Nullable
                                       String a,
                                       @Nullable
                                       String b)
```
    拼接两个字符串（忽略其中为 null 的参数）
    
    从以下版本开始:
    
    3.0.0
  - concat
```
public static String concat(@Nullable
                            String a,
                            @Nullable
                            String b,
                            @Nullable
                            String c)
```
    拼接多个字符串（忽略其中为 null 的参数）
    
    从以下版本开始:
    
    3.0.0
  - append
```
public static StringBuilder append(@Nullable
                                   StringBuilder sb,
                                   String... strs)
```
    拼接多个字符串（忽略其中为 null 的参数）
    
    从以下版本开始:
    
    3.0.0
  - concats
```
public static String concats(String... strs)
```
    拼接多个字符串（忽略其中为 null 的参数）
    
    从以下版本开始:
    
    3.0.0
  - initBuilder
```
public static StringBuilder initBuilder(@Nullable
                                        StringBuilder sb,
                                        int appendLength)
```
    初始化一个还可以添加 appendLength 个字符的 StringBuilder
    
    参数:
    
    sb - 如果为null，内部会自动创建
    
    appendLength - 还需要扩展的字符数
    
    从以下版本开始:
    
    3.0.0
  - isEmpty
```
public static boolean isEmpty(CharSequence cs)
```
    判断指定的字符串是否为空
    如果字符串为null、空字符串，则返回true，否则返回false
    注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用 isBlank(CharSequence) 方法
    
    从以下版本开始:
    
    0.0.1
  - notEmpty
```
public static boolean notEmpty(CharSequence cs)
```
    判断指定的字符串是否不为空
    如果指定字符串不为null、空字符串，则返回true，否则返回false
    注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用 notBlank(CharSequence) 方法
    
    从以下版本开始:
    
    0.0.1
  - isAnyNotEmpty
```
public static boolean isAnyNotEmpty(CharSequence... css)
```
    判断指定的字符序列数组是否存在不为空的元素
    如果数组中存在不为null、空字符串的元素，则返回true，否则返回false
    
    从以下版本开始:
    
    1.0.2
  - isEmpty
```
public static boolean isEmpty(Object obj)
```
    判断指定的对象是否为空
    如果对象(或其 toString() 返回值)为null、空字符串，则返回true
    注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用isBlank(Object obj)方法
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - notEmpty
```
public static boolean notEmpty(Object obj)
```
    判断指定的对象是否不为空
    如果对象(或其 toString() 返回值)不为null、空字符串，则返回true，否则返回false
    注意：本方法不会去除字符串两边的空格，如果需要对字符串进行去除两边空格后的判断，请使用isBlank(Object obj)方法
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - hasEmpty
```
public static boolean hasEmpty(Object... values)
```
    判断指定数组中是否存在为空的值(null、空字符串),如果是将返回true
    本方法接受多个参数，如果其中有任意一个为空，就返回true 如果指定的key不存在也返回true
    
    参数:
    
    values - 指定的数组
    
    另请参阅:
    
    isEmpty(Object)
  - isBlank
```
public static boolean isBlank(CharSequence str)
```
    判断指定的字符串是否为空
    如果字符串为null、空字符串、空格字符串，则返回true
    注意：本方法会先去除字符串两边的空格，再判断
    
    从以下版本开始:
    
    0.0.1
  - notBlank
```
public static boolean notBlank(CharSequence cs)
```
    判断指定的字符串是否不为空
    如果字符串不为null、空字符串、空格字符串，则返回true，否则返回false
    注意：本方法会先去除字符串两边的空格，再判断
    
    从以下版本开始:
    
    0.0.1
  - isBlank
```
public static boolean isBlank(Object obj)
```
    判断指定的对象是否为空
    如果对象(或其 toString() 返回值)为null、空字符串、空格字符串，则返回true
    注意：本方法会先去除字符串两边的空格，再判断
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - notBlank
```
public static boolean notBlank(Object obj)
```
    判断指定的对象是否为空
    如果对象(或其 toString() 返回值)不为null、空字符串、空格字符串，则返回true，否则返回false
    注意：本方法会先去除字符串两边的空格，再判断
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - hasBlank
```
public static boolean hasBlank(Object... values)
```
    判断指定数组中是否为空的值(null、空字符串、空格字符串),如果是，将返回true
    本方法接受多个参数，如果其中有任意一个为空，就返回true
    本方法会去除两边的空格后再判断如果指定的key不存在也返回true
    
    参数:
    
    values - 指定的数组
    
    从以下版本开始:
    
    0.0.1
  - toString
```
public static String toString(Object obj)
```
    以String的形式返回对象值，如果对象为null，则返回""
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - nullSafeGet
```
@Nullable
public static String nullSafeGet(@Nullable
                                            Supplier<? extends CharSequence> msgSupplier)
```
    安全地执行指定的字符串懒加载表达式，并返回对应的字符串
  - nullSafeGet
```
@Nullable
public static String nullSafeGet(@Nullable
                                            CharSequence cs)
```
    安全地获取指定字符序列中的字符串
    
    参数:
    
    cs - 如果该参数为 null，则返回 null
  - toString
```
public static String toString(Object obj,
                              String defaultValIfNull)
```
    以String的形式返回对象值，如果对象为null，则返回""
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - trim
```
public static String trim(Object obj)
```
    以去除两边空格的String形式返回对象值，如果对象为null，则返回""
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - trim4Html
```
public static String trim4Html(Object obj)
```
    以String的形式返回对象值，如果对象为null或空格字符串，则返回" "
    
    参数:
    
    obj - 指定的对象
    
    从以下版本开始:
    
    0.0.1
  - limitChars
```
public static String limitChars(String str,
                                int maxLength,
                                String suffix)
```
    如果指定字符串超过限制长度maxLength,则返回限制长度前面的部分字符串
    如果指定字符串==null，则返回空字符串
    如果字符串超出指定长度，则返回maxLength前面的部分，并在末尾加上后缀suffix
    
    参数:
    
    str - 指定的字符串
    
    maxLength - 最大限制长度
    
    suffix - 超出长度时添加的指定后缀,如果不需要，可以为null
    
    从以下版本开始:
    
    0.0.1
  - limitChars
```
public static String limitChars(String str,
                                int maxLength)
```
    如果指定字符串超过限制长度maxLength,则返回限制长度前面的部分字符串
    如果指定字符串==null，则返回空字符串
    如果字符串超出指定长度，则返回maxLength前面的部分，并在末尾加上后缀“...”
    
    参数:
    
    str - 指定的字符串
    
    maxLength - 最大限制长度
    
    从以下版本开始:
    
    0.0.1
  - zeroFill
```
public static String zeroFill(String str,
                              int maxLength)
```
    如果字符串不足指定位数，则前面补0，直到指定位数
    如果字符串=null，则返回空字符串""
    如果字符串位数大于指定位数，则返回原字符串
    
    参数:
    
    str - 字符串
    
    maxLength - 指定位数，不能小于1
    
    从以下版本开始:
    
    0.0.1
  - leftPad
```
public static String leftPad(String str,
                             char ch,
                             int maxLength)
```
    如果字符串不足指定位数，则在前面补充指定的字符，直到指定位数
    如果字符串=null，则返回空字符串""
    如果字符串位数大于指定位数，则返回原字符串
    
    参数:
    
    str - 字符串
    
    ch - 指定的字符
    
    maxLength - 指定位数，不能小于1
    
    从以下版本开始:
    
    0.0.1
  - rightPad
```
public static String rightPad(String str,
                              char ch,
                              int maxLength)
```
    如果字符串不足指定位数，则在后面补充指定的字符，直到指定位数
    如果字符串=null，则返回空字符串""
    如果字符串位数大于指定位数，则返回原字符串
    
    参数:
    
    str - 字符串
    
    ch - 指定的字符
    
    maxLength - 指定位数，不能小于1
    
    从以下版本开始:
    
    0.0.1
  - trim
```
public static String trim(String str)
```
    去除字符串两侧的空白字符
    如果为null则返回空字符串""
    
    从以下版本开始:
    
    0.0.1
  - replaceChars
```
public static String replaceChars(String str,
                                  char ch,
                                  int beginIndex,
                                  int endIndex)
```
    将指定字符串的 beginIndex 到 endIndex (不包括 endIndex ) 之间的字符全部替换为字符 ch
    
    参数:
    
    str - 指定的字符串
    
    ch - 指定的字符
    
    beginIndex - 指定的字符串起始索引(可以为负数，表示 beginIndex + str.length() )
    
    endIndex - 指定的字符串结束索引(可以为负数，表示 endIndex + str.length() )
    
    从以下版本开始:
    
    0.1.1
  - ensureRangeSafe
```
public static int[] ensureRangeSafe(int beginIndex,
                                    int endIndex,
                                    int length)
```
    确保起始和结束索引的范围边界安全，并返回范围安全的 [开始索引, 结束索引] 数组
    如果索引参数为负，自动加上 length，如果处理后的 beginIndex > endIndex，则自动对调位置
    方法起始索引或结束索引超出合理边界，方法内会尽可能地根据 length 进行调整：
    1、如果 beginIndex < -length ，则 beginIndex = 0
    2、如果 endIndex > length ，则 endIndex = length
    
    参数:
    
    beginIndex - 起始索引
    
    endIndex - 结束索引
    
    length - 指定数组、集合或字符串的长度，不能小于0
    
    返回:
    
    如果范围安全则返回对应的范围数组，否则返回null
    
    从以下版本开始:
    
    0.4.2
  - replaceChars
```
public static String replaceChars(String str,
                                  char ch,
                                  int beginIndex)
```
    将指定字符串的 beginIndex 到末尾之间的字符全部替换为字符 ch
    
    参数:
    
    str - 指定的字符串
    
    ch - 指定的字符
    
    beginIndex - 指定的字符串起始索引(可以为负数，表示 beginIndex + str.length() )
    
    从以下版本开始:
    
    0.1.1
  - replaceSubstring
```
public static String replaceSubstring(String str,
                                      String replacement,
                                      int beginIndex,
                                      int endIndex)
```
    将指定字符串的 beginIndex 到 endIndex (不包括 endIndex ) 之间的子字符串全部替换为指定的字符串 replacement
    
    参数:
    
    str - 指定的字符串
    
    replacement - 指定的字符串
    
    beginIndex - 指定的字符串起始索引(可以为负数，表示 beginIndex + str.length() )
    
    endIndex - 指定的字符串结束索引(可以为负数，表示 endIndex + str.length() )
    
    从以下版本开始:
    
    0.1.1
  - replaceSubstring
```
public static String replaceSubstring(String str,
                                      String replacement,
                                      int beginIndex)
```
    将指定字符串的 beginIndex 及其后的子字符串全部替换为指定的字符串 replacement
    
    参数:
    
    str - 指定的字符串
    
    replacement - 指定的字符串
    
    beginIndex - 指定的字符串起始索引(可以为负数，表示 beginIndex + str.length() )
    
    从以下版本开始:
    
    0.1.1
  - convertCharset
```
public static String convertCharset(String str,
                                    Charset originalCharset,
                                    Charset targetCharset)
```
    将字符串从指定字符集编码转换为目标字符集编码
    
    参数:
    
    str - 指定的字符串
    
    originalCharset - 原始字符集编码
    
    targetCharset - 目标字符集编码
    
    从以下版本开始:
    
    0.3.9
  - convertCharsetForURI
```
public static String convertCharsetForURI(String str,
                                          Charset targetCharset)
```
    将指定的URI参数字符串转换为目标字符集编码
    本方法实际上是将字符串从ISO-8859-1编码转换为指定的目标编码
    
    参数:
    
    str - 指定的URI参数字符串
    
    targetCharset - 目标字符集编码
    
    从以下版本开始:
    
    0.3.9
  - reverse
```
public static String reverse(CharSequence str)
```
    颠倒(反转)字符串的字符顺序，并返回颠倒后的字符串
    如果字符串为null，则返回空字符串""
    
    参数:
    
    str - 指定的字符串
    
    从以下版本开始:
    
    0.0.1
  - startsWith
```
public static boolean startsWith(String str,
                                 char firstChar)
```
    判断指定字符串是否以指定的单个字符开头
    
    参数:
    
    str - 指定的字符串
    
    firstChar - 指定的单个字符
    
    从以下版本开始:
    
    0.4.2
  - endsWith
```
public static boolean endsWith(String str,
                               char lastChar)
```
    判断指定字符串是否以指定的单个字符结尾
    
    参数:
    
    str - 指定的字符串
    
    lastChar - 指定的单个字符
    
    从以下版本开始:
    
    0.4.2
  - escape
```
public static StringBuilder escape(@Nullable
                                   StringBuilder sb,
                                   String str,
                                   char escapeChar,
                                   char[] escapedChars)
```
    使用转义字符转义字符串中指定的字符
    
    参数:
    
    sb - 用于字符拼接的 StringBuilder
    
    str - 需要转义的字符串
    
    escapeChar - 转义字符
    
    escapedChars - 需要被转义的字符的数组
  - escape
```
public static String escape(String str,
                            char escapeChar,
                            char[] escapedChars)
```
    使用转义字符转义字符串中指定的字符
    
    参数:
    
    str - 需要转义的字符串
    
    escapeChar - 转义字符
    
    escapedChars - 需要被转义的字符的数组
  - unescape
```
public static StringBuilder unescape(@Nullable
                                     StringBuilder sb,
                                     String escapedStr,
                                     char escapeChar,
                                     char[] escapedChars)
```
    解除对使用 escape(StringBuilder, String, char, char[]) 方法转义后的字符串的转义
    
    参数:
    
    escapedStr - 被转义后的字符串
    
    escapeChar - 转义字符
    
    escapedChars - 已经被转义过的字符的数组
  - unescape
```
public static String unescape(String escapedStr,
                              char escapeChar,
                              char[] escapedChars)
```
    解除对使用 escape(StringBuilder, String, char, char[]) 方法转义后的字符串的转义
    
    参数:
    
    escapedStr - 被转义后的字符串
    
    escapeChar - 转义字符
    
    escapedChars - 已经被转义过的字符的数组
  - escapeSQLLike
```
@Nullable
public static StringBuilder escapeSQLLike(@Nullable
                                                     StringBuilder sb,
                                                     String likeStr,
                                                     char escapeChar,
                                                     boolean appendWildcardAtStart,
                                                     boolean appendWildcardAtEnd)
```
    使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
    
    参数:
    
    sb - 用于拼接字符的 StringBuilder，如果为 null，则内部会在需要时自动创建
    
    likeStr - 指定的字符串
    
    escapeChar - 转义字符
    
    appendWildcardAtStart - 是否需要在字符串开头添加通配符'%'
    
    appendWildcardAtEnd - 是否需要在字符串末尾添加通配符'%'
    
    返回:
    
    如果 sb 为 null，且 likeStr 为空时，返回 null
    
    从以下版本开始:
    
    3.0.0
  - escapeSQLLike
```
public static String escapeSQLLike(String likeStr,
                                   char escapeChar,
                                   boolean appendWildcardAtStart,
                                   boolean appendWildcardAtEnd)
```
    使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
    
    参数:
    
    likeStr - 指定的字符串
    
    escapeChar - 转义字符
    
    appendWildcardAtStart - 是否需要在字符串开头添加通配符'%'
    
    appendWildcardAtEnd - 是否需要在字符串末尾添加通配符'%'
    
    从以下版本开始:
    
    2.9
  - escapeSQLLike
```
public static String escapeSQLLike(String likeStr,
                                   boolean appendWildcardAtStart,
                                   boolean appendWildcardAtEnd)
```
    使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
    
    参数:
    
    likeStr - 指定的字符串
    
    appendWildcardAtStart - 是否需要在字符串开头添加通配符'%'
    
    appendWildcardAtEnd - 是否需要在字符串末尾添加通配符'%'
    
    从以下版本开始:
    
    2.9
  - escapeSQLLike
```
public static String escapeSQLLike(String likeStr,
                                   char escapeChar,
                                   boolean appendWildcardAtBoth)
```
    使用指定的转义字符对用于LIKE语句的字符串进行转义，以防止SQL语句注入
    
    参数:
    
    likeStr - 指定的字符串
    
    escapeChar - 转义字符
    
    appendWildcardAtBoth - 是否需要在字符串两侧都添加通配符'%'
    
    从以下版本开始:
    
    0.3.5
  - escapeSQLLike
```
public static String escapeSQLLike(String likeStr,
                                   boolean appendLikeWildcard)
```
    将指定的用于LIKE语句的字符串转义，以防止SQL语句注入
    该方法默认使用'\'进行转义操作
    
    参数:
    
    likeStr - 指定的字符串
    
    appendLikeWildcard - 是否需要在字符串两侧添加通配符'%'
    
    从以下版本开始:
    
    0.3.5
  - escapeSQLLike
```
public static String escapeSQLLike(String likeStr)
```
    将指定的用于LIKE语句的字符串转义，以防止SQL语句注入
    该方法默认使用'\'进行转义操作
    
    参数:
    
    likeStr - 指定的字符串
    
    从以下版本开始:
    
    0.3.5
  - containsWord
```
public static boolean containsWord(String container,
                                   String search,
                                   String seperatorChars,
                                   boolean fastMode)
```
    检测指定字符串中是否存在指定的单词
    
    参数:
    
    container - 待检测的字符串
    
    search - 指定的单词
    
    seperatorChars - 单词两侧必须是指定的字符之一或位于字符串 container 的首/尾位置
    
    fastMode - 是否启用快速模式。快速模式：如果在 container 中第一次检索到该单词，就直接在此处进行周边字符的匹配测试，并返回测试结果。
    哪怕后面还会再次出现该单词，也不再继续向后检查。请参考重载方法 containsWord(String, String, String) 方法上的注释
    
    从以下版本开始:
    
    2.0.0
  - containsWord
```
public static boolean containsWord(String container,
                                   String searchedWord,
                                   String seperatorChars)
```
    检测指定字符串中是否存在指定的单词
    该方法采用快速模式，对于类似 containsWord("abc123,123", "123", ",") 等特殊情况无法保证100%可靠；如果想要保证可靠性，建议使用 containsWord(String, String, String, boolean)
    
    参数:
    
    container - 待检测的字符串
    
    searchedWord - 指定的单词
    
    seperatorChars - 单词两侧必须是指定的字符之一或位于字符串 container 的首/尾位置
    
    从以下版本开始:
    
    0.4.2
    
    另请参阅:
    
    containsWord(String, String, String, boolean)
  - capitalize
```
public static String capitalize(String str)
```
    将字符串的首字母大写
  - decapitalize
```
public static String decapitalize(String str)
```
    将字符串的首字母小写
  - replaceChar
```
public static String replaceChar(String str,
                                 int charIndex,
                                 CharConverter converter)
                          throws IndexOutOfBoundsException
```
    替换字符串中指定位置的字符，并返回替换后的结果
    
    抛出:
    
    IndexOutOfBoundsException - 索引越界时会抛出该异常。不过请注意：如果 str 为 null 时，将直接返回 null，而不会抛出 NPE
  - split
```
public static <T> List<T> split(String str,
                                String sep,
                                Function<? super String,T> mapper,
                                boolean ignoreNull)
```
    将以指定分隔字符分隔字符串，并将拆分后的每个片段文本使用指定的 mapper 进行转换，并返回转换后的元素集合
    
    参数:
    
    str - 需要被拆分的字符串
    
    sep - 分隔符
    
    mapper - 转换器
    
    ignoreNull - 是否忽略 null 值（如果为 true，则返回的集合中不会包含 null ）
  - split
```
public static <T> List<T> split(String str,
                                String sep,
                                Function<String,T> mapper)
```
    将以指定分隔字符分隔字符串，并将拆分后的每个片段文本使用指定的 mapper 进行转换，并返回转换后的元素集合
    
    参数:
    
    str - 需要被拆分的字符串
    
    sep - 分隔符
    
    mapper - 转换器

类 StringUtil

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

digits

构造器详细资料

StringUtil

方法详细资料

unicode

fastUnicode

getBuilder

length

getBuilder

getBuilder

getBuilder

getBuilder

concat

concat

append

concats

initBuilder

isEmpty

notEmpty

isAnyNotEmpty

isEmpty

notEmpty

hasEmpty

isBlank

notBlank

isBlank

notBlank

hasBlank

toString

nullSafeGet

nullSafeGet

toString

trim

trim4Html

limitChars

limitChars

zeroFill

leftPad

rightPad

trim

replaceChars

ensureRangeSafe

replaceChars

replaceSubstring

replaceSubstring

convertCharset

convertCharsetForURI

reverse

startsWith

endsWith

escape

escape

unescape

unescape

escapeSQLLike

escapeSQLLike

escapeSQLLike

escapeSQLLike

escapeSQLLike

escapeSQLLike

containsWord

containsWord

capitalize

decapitalize

replaceChar

split

split