StrBuilder (hutool 5.8.33 API)

java.lang.Object
- cn.hutool.core.text.StrBuilder

All Implemented Interfaces:

Serializable, Appendable, CharSequence
```
public class StrBuilder
extends Object
implements CharSequence, Appendable, Serializable
```
可复用的字符串生成器，非线程安全
TODO 6.x移除此类，java8的StringBuilder非常完善了，无需重写。

Since:

4.0.0

Author:

Looly

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static int DEFAULT_CAPACITY
默认容量

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_CAPACITY` 默认容量

Constructor Summary

Constructors
Constructor and Description

StrBuilder()
构造

StrBuilder(CharSequence... strs)
构造

StrBuilder(int initialCapacity)
构造

Constructors
Constructor and Description
`StrBuilder()` 构造
`StrBuilder(CharSequence... strs)` 构造
`StrBuilder(int initialCapacity)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`StrBuilder`	`append(char c)` 追加一个字符
`StrBuilder`	`append(char[] src)` 追加一个字符数组
`StrBuilder`	`append(char[] src, int srcPos, int length)` 追加一个字符数组
`StrBuilder`	`append(CharSequence csq)`
`StrBuilder`	`append(CharSequence csq, int start, int end)`
`StrBuilder`	`append(Object obj)` 追加对象，对象会被转换为字符串
`char`	`charAt(int index)`
`StrBuilder`	`clear()` 删除全部字符，位置归零
`static StrBuilder`	`create()` 创建字符串构建器
`static StrBuilder`	`create(CharSequence... strs)` 创建字符串构建器
`static StrBuilder`	`create(int initialCapacity)` 创建字符串构建器
`StrBuilder`	`del(int start, int end)` 删除指定长度的字符，规则如下： 1、end大于等于最大长度，结束按照最大长度计算，相当于删除start之后虽有部分（性能最好） 2、end小于start时，抛出StringIndexOutOfBoundsException 3、start小于0 按照0处理 4、start等于end不处理 5、start和end都位于长度区间内，删除这段内容（内存拷贝）
`StrBuilder`	`delTo(int newPosition)` 删除到指定位置如果新位置小于等于0，则删除全部
`StrBuilder`	`getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)` 将指定段的字符列表写出到目标字符数组中
`boolean`	`hasContent()` 是否有内容
`StrBuilder`	`insert(int index, char c)` 插入指定字符
`StrBuilder`	`insert(int index, char[] src)` 指定位置插入数据如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StrBuilder`	`insert(int index, char[] src, int srcPos, int length)` 指定位置插入数据如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StrBuilder`	`insert(int index, CharSequence csq)` 指定位置插入字符串的某个部分如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StrBuilder`	`insert(int index, CharSequence csq, int start, int end)` 指定位置插入字符串的某个部分如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StrBuilder`	`insert(int index, Object obj)` 追加对象，对象会被转换为字符串
`boolean`	`isEmpty()` 是否为空
`int`	`length()`
`StrBuilder`	`reset()` 删除全部字符，位置归零
`CharSequence`	`subSequence(int start, int end)`
`String`	`subString(int start)` 返回自定段的字符串
`String`	`subString(int start, int end)` 返回自定段的字符串
`String`	`toString()` 生成字符串
`String`	`toString(boolean isReset)` 生成字符串
`String`	`toStringAndReset()` 重置并返回生成的字符串

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

Methods inherited from interface java.lang.CharSequence
chars, codePoints

- Field Detail
  - DEFAULT_CAPACITY
```
public static final int DEFAULT_CAPACITY
```
    默认容量
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - StrBuilder
```
public StrBuilder()
```
    构造
  - StrBuilder
```
public StrBuilder(int initialCapacity)
```
    构造
    
    Parameters:
    
    initialCapacity - 初始容量
  - StrBuilder
```
public StrBuilder(CharSequence... strs)
```
    构造
    
    Parameters:
    
    strs - 初始字符串
    
    Since:
    
    4.0.1
- Method Detail
  - create
```
public static StrBuilder create()
```
    创建字符串构建器
    
    Returns:
    
    this
  - create
```
public static StrBuilder create(int initialCapacity)
```
    创建字符串构建器
    
    Parameters:
    
    initialCapacity - 初始容量
    
    Returns:
    
    this
  - create
```
public static StrBuilder create(CharSequence... strs)
```
    创建字符串构建器
    
    Parameters:
    
    strs - 初始字符串
    
    Returns:
    
    this
    
    Since:
    
    4.0.1
  - append
```
public StrBuilder append(Object obj)
```
    追加对象，对象会被转换为字符串
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    this
  - append
```
public StrBuilder append(char c)
```
    追加一个字符
    
    Specified by:
    
    append in interface Appendable
    
    Parameters:
    
    c - 字符
    
    Returns:
    
    this
  - append
```
public StrBuilder append(char[] src)
```
    追加一个字符数组
    
    Parameters:
    
    src - 字符数组
    
    Returns:
    
    this
  - append
```
public StrBuilder append(char[] src,
                         int srcPos,
                         int length)
```
    追加一个字符数组
    
    Parameters:
    
    src - 字符数组
    
    srcPos - 开始位置（包括）
    
    length - 长度
    
    Returns:
    
    this
  - append
```
public StrBuilder append(CharSequence csq)
```
    Specified by:
    
    append in interface Appendable
  - append
```
public StrBuilder append(CharSequence csq,
                         int start,
                         int end)
```
    Specified by:
    
    append in interface Appendable
  - insert
```
public StrBuilder insert(int index,
                         Object obj)
```
    追加对象，对象会被转换为字符串
    
    Parameters:
    
    index - 插入位置
    
    obj - 对象
    
    Returns:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char c)
```
    插入指定字符
    
    Parameters:
    
    index - 位置
    
    c - 字符
    
    Returns:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char[] src)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    Parameters:
    
    index - 插入位置
    
    src - 源数组
    
    Returns:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char[] src,
                         int srcPos,
                         int length)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    Parameters:
    
    index - 插入位置
    
    src - 源数组
    
    srcPos - 位置
    
    length - 长度
    
    Returns:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         CharSequence csq)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    Parameters:
    
    index - 位置
    
    csq - 字符串
    
    Returns:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         CharSequence csq,
                         int start,
                         int end)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    Parameters:
    
    index - 位置
    
    csq - 字符串
    
    start - 字符串开始位置（包括）
    
    end - 字符串结束位置（不包括）
    
    Returns:
    
    this
  - getChars
```
public StrBuilder getChars(int srcBegin,
                           int srcEnd,
                           char[] dst,
                           int dstBegin)
```
    将指定段的字符列表写出到目标字符数组中
    
    Parameters:
    
    srcBegin - 起始位置（包括）
    
    srcEnd - 结束位置（不包括）
    
    dst - 目标数组
    
    dstBegin - 目标起始位置（包括）
    
    Returns:
    
    this
  - hasContent
```
public boolean hasContent()
```
    是否有内容
    
    Returns:
    
    是否有内容
  - isEmpty
```
public boolean isEmpty()
```
    是否为空
    
    Returns:
    
    是否为空
  - clear
```
public StrBuilder clear()
```
    删除全部字符，位置归零
    
    Returns:
    
    this
  - reset
```
public StrBuilder reset()
```
    删除全部字符，位置归零
    
    Returns:
    
    this
  - delTo
```
public StrBuilder delTo(int newPosition)
```
    删除到指定位置
    如果新位置小于等于0，则删除全部
    
    Parameters:
    
    newPosition - 新的位置，不包括这个位置
    
    Returns:
    
    this
  - del
```
public StrBuilder del(int start,
                      int end)
               throws StringIndexOutOfBoundsException
```
    删除指定长度的字符，规则如下：
```
 1、end大于等于最大长度，结束按照最大长度计算，相当于删除start之后虽有部分（性能最好）
 2、end小于start时，抛出StringIndexOutOfBoundsException
 3、start小于0 按照0处理
 4、start等于end不处理
 5、start和end都位于长度区间内，删除这段内容（内存拷贝）
 
```
    Parameters:
    
    start - 开始位置，负数按照0处理（包括）
    
    end - 结束位置，超出最大长度按照最大长度处理（不包括）
    
    Returns:
    
    this
    
    Throws:
    
    StringIndexOutOfBoundsException - 当start > end抛出此异常
  - toString
```
public String toString(boolean isReset)
```
    生成字符串
    
    Parameters:
    
    isReset - 是否重置，重置后相当于空的构建器
    
    Returns:
    
    生成的字符串
  - toStringAndReset
```
public String toStringAndReset()
```
    重置并返回生成的字符串
    
    Returns:
    
    字符串
  - toString
```
public String toString()
```
    生成字符串
    
    Specified by:
    
    toString in interface CharSequence
    
    Overrides:
    
    toString in class Object
  - length
```
public int length()
```
    Specified by:
    
    length in interface CharSequence
  - charAt
```
public char charAt(int index)
```
    Specified by:
    
    charAt in interface CharSequence
  - subSequence
```
public CharSequence subSequence(int start,
                                int end)
```
    Specified by:
    
    subSequence in interface CharSequence
  - subString
```
public String subString(int start)
```
    返回自定段的字符串
    
    Parameters:
    
    start - 开始位置（包括）
    
    Returns:
    
    this
  - subString
```
public String subString(int start,
                        int end)
```
    返回自定段的字符串
    
    Parameters:
    
    start - 开始位置（包括）
    
    end - 结束位置（不包括）
    
    Returns:
    
    this

Class StrBuilder

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.CharSequence

Field Detail

DEFAULT_CAPACITY

Constructor Detail

StrBuilder

StrBuilder

StrBuilder

Method Detail

create

create

create

append

append

append

append

append

append

insert

insert

insert

insert

insert

insert

getChars

hasContent

isEmpty

clear

reset

delTo

del

toString

toStringAndReset

toString

length

charAt

subSequence

subString

subString