StrUtil (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.text.StrValidator
- - org.dromara.hutool.core.text.CharSequenceUtil
  - - org.dromara.hutool.core.text.StrUtil

All Implemented Interfaces:

StrPool
```
public class StrUtil
extends CharSequenceUtil
implements StrPool
```
字符串工具类
此工具主要针对单个字符串的操作
本工具类，v6.x进行了拆分。字符串分割split参考：SplitUtil
多字符串判空hasBlank参考：ArrayUtil

Author:

Looly

See Also:

对字符串分割, 对多个字符串判空

Field Summary
- Fields inherited from class org.dromara.hutool.core.text.CharSequenceUtil
  INDEX_NOT_FOUND
- Fields inherited from class org.dromara.hutool.core.text.StrValidator
  EMPTY, NULL
- Fields inherited from interface org.dromara.hutool.core.text.StrPool
  AT, BACKSLASH, BRACKET_END, BRACKET_START, COLON, COMMA, CR, CRLF, DASHED, DELIM_END, DELIM_START, DOT, DOUBLE_DOT, EMPTY_JSON, LF, SLASH, SPACE, TAB, UNDERLINE

Constructor Summary

Constructors
Constructor and Description

StrUtil()

Constructors
Constructor and Description
`StrUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static StringBuilder`	`builder()` 创建StringBuilder对象
`static StringBuilder`	`builder(int capacity)` 创建StringBuilder对象
`static String`	`fill(String str, char filledChar, int len, boolean isPre)` 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串
`static String`	`fillAfter(String str, char filledChar, int len)` 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串字符填充于字符串后
`static String`	`fillBefore(String str, char filledChar, int len)` 将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串字符填充于字符串前
`static StringReader`	`getReader(CharSequence str)` 获得StringReader
`static StringWriter`	`getWriter()` 获得StringWriter
`static boolean`	`isBlankIfStr(Object obj)` 如果对象是字符串是否为空白，空白的定义如下： `null` 空字符串：`""` 空格、全角空格、制表符、换行符，等不可见字符例： `StrUtil.isBlankIfStr(null) // true` `StrUtil.isBlankIfStr("") // true` `StrUtil.isBlankIfStr(" \t\n") // true` `StrUtil.isBlankIfStr("abc") // false` 注意：该方法与 `isEmptyIfStr(Object)` 的区别是：该方法会校验空白字符，且性能相对于 `isEmptyIfStr(Object)` 略慢。
`static boolean`	`isEmptyIfStr(Object obj)` 如果对象是字符串是否为空串，空的定义如下： `null` 空字符串：`""` 例： `StrUtil.isEmptyIfStr(null) // true` `StrUtil.isEmptyIfStr("") // true` `StrUtil.isEmptyIfStr(" \t\n") // false` `StrUtil.isEmptyIfStr("abc") // false` 注意：该方法与 `isBlankIfStr(Object)` 的区别是：该方法不校验空白字符。
`static String`	`reverse(String str)` 反转字符串例如：abcd =》dcba
`static double`	`similar(String str1, String str2)` 计算两个字符串的相似度
`static String`	`similar(String str1, String str2, int scale)` 计算两个字符串的相似度百分比
`static String`	`str(byte[] data, Charset charset)` 解码字节码
`static String`	`str(Byte[] data, Charset charset)` 解码字节码
`static String`	`str(ByteBuffer data, Charset charset)` 将编码的byteBuffer数据转换为字符串
`static String`	`str(Object obj, Charset charset)` 将对象转为字符串 1、Byte数组和ByteBuffer会被转换为对应字符串的数组 2、char[]会直接构造String 3、对象数组会调用Arrays.toString方法
`static String`	`strFast(char[] value)` JDK8中，通过`String(char[] value, boolean share)`这个内部构造创建String对象。
`static void`	`trim(String[] strs)` 给定字符串数组全部做去首尾空格
`static String`	`utf8Str(Object obj)` 将对象转为字符串 1、Byte数组和ByteBuffer会被转换为对应字符串的数组 2、对象数组会调用Arrays.toString方法

Methods inherited from class org.dromara.hutool.core.text.CharSequenceUtil
addPrefixIfNot, addSuffixIfNot, appendIfMissing, appendIfMissing, appendIfMissingIgnoreCase, brief, builder, builder, byteLength, center, center, center, cleanBlank, codeLength, commonPrefix, commonSuffix, compare, compareIgnoreCase, compareVersion, concat, contains, contains, containsAll, containsAny, containsAny, containsAnyIgnoreCase, containsBlank, containsIgnoreCase, containsOnly, count, count, cut, defaultIfBlank, defaultIfBlank, defaultIfBlank, defaultIfEmpty, defaultIfEmpty, defaultIfEmpty, defaultIfNull, defaultIfNull, defaultIfNull, emptyIfNull, endWith, endWith, endWith, endWith, endWithAny, endWithAnyIgnoreCase, endWithIgnoreCase, equals, equals, equalsAny, equalsAny, equalsAnyIgnoreCase, equalsCharAt, equalsIgnoreCase, filter, firstNonBlank, firstNonEmpty, firstNonNull, fixLength, forEach, forEach, format, formatByBean, formatByMap, formatByMap, getContainsStr, getContainsStrIgnoreCase, hide, indexedFormat, indexOf, indexOf, indexOf, indexOf, indexOf, indexOfIgnoreCase, indexOfIgnoreCase, isCharEquals, isLowerCase, isNumeric, isSubEquals, isSubEquals, isUpperCase, isWrap, isWrap, isWrap, isWrap, join, join, lastIndexOf, lastIndexOfIgnoreCase, lastIndexOfIgnoreCase, length, limitByteLength, limitByteLengthUtf8, limitLength, lowerAt, lowerFirst, move, normalize, nullIfBlank, nullIfEmpty, ordinalIndexOf, padAfter, padAfter, padPre, padPre, prependIfMissing, prependIfMissing, prependIfMissingIgnoreCase, removeAll, removeAll, removeAll, removeAllLineBreaks, removeAllPrefix, removeAllSuffix, removePreAndLowerFirst, removePreAndLowerFirst, removePrefix, removePrefix, removePrefixIgnoreCase, removeSufAndLowerFirst, removeSuffix, removeSuffixIgnoreCase, repeat, repeat, repeatAndJoin, repeatByLength, replace, replace, replace, replace, replace, replaceAt, replaceByCodePoint, replaceByCodePoint, replaceChars, replaceChars, replaceFirst, replaceIgnoreCase, replaceLast, startWith, startWith, startWith, startWith, startWithAny, startWithAnyIgnoreCase, startWithIgnoreCase, startWithIgnoreEquals, strip, strip, strip, stripAll, stripAll, stripAll, stripIgnoreCase, stripIgnoreCase, sub, subAfter, subAfter, subBefore, subBefore, subBetween, subBetween, subBetweenAll, subBetweenAll, subByCodePoint, subByLength, subPre, subPreGbk, subPreGbk, subSuf, subSufByLength, swapCase, toCamelCase, toCamelCase, toChars, toString, toStringOrEmpty, toStringOrNull, toSymbolCase, totalLength, toUnderlineCase, trim, trim, trim, trimPrefix, trimSuffix, trimToEmpty, trimToNull, unWrap, unWrap, unWrap, upperAt, upperFirst, upperFirstAndAddPre, wrap, wrap, wrap, wrapAll, wrapAllIfMissing, wrapAllWithPair, wrapAllWithPairIfMissing, wrapIfMissing

Methods inherited from class org.dromara.hutool.core.text.StrValidator
hasBlank, hasEmpty, hasEmpty, isAllBlank, isAllCharMatch, isAllEmpty, isAllEmpty, isAllNotBlank, isAllNotEmpty, isBlank, isBlankOrUndefined, isEmpty, isEmptyOrUndefined, isNotBlank, isNotEmpty, isNullOrUndefined

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - StrUtil
```
public StrUtil()
```
- Method Detail
  - isBlankIfStr
```
public static boolean isBlankIfStr(Object obj)
```
    如果对象是字符串是否为空白，空白的定义如下：
    1. null
    2. 空字符串：""
    3. 空格、全角空格、制表符、换行符，等不可见字符
    例：
    - StrUtil.isBlankIfStr(null) // true
    - StrUtil.isBlankIfStr("") // true
    - StrUtil.isBlankIfStr(" \t\n") // true
    - StrUtil.isBlankIfStr("abc") // false
    注意：该方法与 isEmptyIfStr(Object) 的区别是：该方法会校验空白字符，且性能相对于 isEmptyIfStr(Object) 略慢。
    Parameters:
    
    obj - 对象
    
    Returns:
    
    如果为字符串是否为空串
    
    Since:
    
    3.3.0
    
    See Also:
    
    StrValidator.isBlank(CharSequence)
  - isEmptyIfStr
```
public static boolean isEmptyIfStr(Object obj)
```
    如果对象是字符串是否为空串，空的定义如下：
    1. null
    2. 空字符串：""
    例：
    - StrUtil.isEmptyIfStr(null) // true
    - StrUtil.isEmptyIfStr("") // true
    - StrUtil.isEmptyIfStr(" \t\n") // false
    - StrUtil.isEmptyIfStr("abc") // false
    注意：该方法与 isBlankIfStr(Object) 的区别是：该方法不校验空白字符。
    Parameters:
    
    obj - 对象
    
    Returns:
    
    如果为字符串是否为空串
    
    Since:
    
    3.3.0
  - trim
```
public static void trim(String[] strs)
```
    给定字符串数组全部做去首尾空格
    
    Parameters:
    
    strs - 字符串数组
  - utf8Str
```
public static String utf8Str(Object obj)
```
    将对象转为字符串
```
 1、Byte数组和ByteBuffer会被转换为对应字符串的数组
 2、对象数组会调用Arrays.toString方法
 
```
    Parameters:
    
    obj - 对象
    
    Returns:
    
    字符串
  - str
```
public static String str(Object obj,
                         Charset charset)
```
    将对象转为字符串
```
         1、Byte数组和ByteBuffer会被转换为对应字符串的数组
         2、char[]会直接构造String
         3、对象数组会调用Arrays.toString方法
 
```
    Parameters:
    
    obj - 对象
    
    charset - 字符集
    
    Returns:
    
    字符串
  - str
```
public static String str(byte[] data,
                         Charset charset)
```
    解码字节码
    
    Parameters:
    
    data - 字符串
    
    charset - 字符集，如果此字段为空，则解码的结果取决于平台
    
    Returns:
    
    解码后的字符串
  - str
```
public static String str(Byte[] data,
                         Charset charset)
```
    解码字节码
    
    Parameters:
    
    data - 字符串
    
    charset - 字符集，如果此字段为空，则解码的结果取决于平台
    
    Returns:
    
    解码后的字符串
  - str
```
public static String str(ByteBuffer data,
                         Charset charset)
```
    将编码的byteBuffer数据转换为字符串
    
    Parameters:
    
    data - 数据
    
    charset - 字符集，如果为空使用当前系统字符集
    
    Returns:
    
    字符串
  - strFast
```
public static String strFast(char[] value)
```
    JDK8中，通过String(char[] value, boolean share)这个内部构造创建String对象。
    此函数通过传入char[]，实现zero-copy的String创建，效率很高。但是要求传入的char[]不可以在其他地方修改。
    
    Parameters:
    
    value - char[]值，注意这个数组不可修改！！
    
    Returns:
    
    String
  - builder
```
public static StringBuilder builder()
```
    创建StringBuilder对象
    
    Returns:
    
    StringBuilder对象
  - builder
```
public static StringBuilder builder(int capacity)
```
    创建StringBuilder对象
    
    Parameters:
    
    capacity - 初始大小
    
    Returns:
    
    StringBuilder对象
  - getReader
```
public static StringReader getReader(CharSequence str)
```
    获得StringReader
    
    Parameters:
    
    str - 字符串
    
    Returns:
    
    StringReader
  - getWriter
```
public static StringWriter getWriter()
```
    获得StringWriter
    
    Returns:
    
    StringWriter
  - reverse
```
public static String reverse(String str)
```
    反转字符串
    例如：abcd =》dcba
    
    Parameters:
    
    str - 被反转的字符串
    
    Returns:
    
    反转后的字符串
    
    Since:
    
    3.0.9
  - fillBefore
```
public static String fillBefore(String str,
                                char filledChar,
                                int len)
```
    将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串
    字符填充于字符串前
    
    Parameters:
    
    str - 被填充的字符串
    
    filledChar - 填充的字符
    
    len - 填充长度
    
    Returns:
    
    填充后的字符串
    
    Since:
    
    3.1.2
  - fillAfter
```
public static String fillAfter(String str,
                               char filledChar,
                               int len)
```
    将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串
    字符填充于字符串后
    
    Parameters:
    
    str - 被填充的字符串
    
    filledChar - 填充的字符
    
    len - 填充长度
    
    Returns:
    
    填充后的字符串
    
    Since:
    
    3.1.2
  - fill
```
public static String fill(String str,
                          char filledChar,
                          int len,
                          boolean isPre)
```
    将已有字符串填充为规定长度，如果已有字符串超过这个长度则返回这个字符串
    
    Parameters:
    
    str - 被填充的字符串
    
    filledChar - 填充的字符
    
    len - 填充长度
    
    isPre - 是否填充在前
    
    Returns:
    
    填充后的字符串
    
    Since:
    
    3.1.2
  - similar
```
public static double similar(String str1,
                             String str2)
```
    计算两个字符串的相似度
    
    Parameters:
    
    str1 - 字符串1
    
    str2 - 字符串2
    
    Returns:
    
    相似度
    
    Since:
    
    3.2.3
  - similar
```
public static String similar(String str1,
                             String str2,
                             int scale)
```
    计算两个字符串的相似度百分比
    
    Parameters:
    
    str1 - 字符串1
    
    str2 - 字符串2
    
    scale - 相似度
    
    Returns:
    
    相似度百分比
    
    Since:
    
    3.2.3

Class StrUtil

Field Summary

Fields inherited from class org.dromara.hutool.core.text.CharSequenceUtil

Fields inherited from class org.dromara.hutool.core.text.StrValidator

Fields inherited from interface org.dromara.hutool.core.text.StrPool

Constructor Summary

Method Summary

Methods inherited from class org.dromara.hutool.core.text.CharSequenceUtil

Methods inherited from class org.dromara.hutool.core.text.StrValidator

Methods inherited from class java.lang.Object

Constructor Detail

StrUtil

Method Detail

isBlankIfStr

isEmptyIfStr

trim

utf8Str

str

str

str

str

strFast

builder

builder

getReader

getWriter

reverse

fillBefore

fillAfter

fill

similar

similar