StrBuilder (java-sdk-common 1.0.2 API)

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

所有已实现的接口:

Serializable, Appendable, CharSequence
```
public class StrBuilder
extends Object
implements CharSequence, Appendable, Serializable
```
可复用的字符串生成器，非线程安全

从以下版本开始:

4.0.0

作者:

Looly

另请参阅:

序列化表格

字段概要

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

static int DEFAULT_CAPACITY
默认容量

字段
限定符和类型	字段和说明
`static int`	`DEFAULT_CAPACITY` 默认容量

构造器概要

构造器
构造器和说明

StrBuilder()
构造

StrBuilder(CharSequence... strs)
构造

StrBuilder(int initialCapacity)
构造

构造器
构造器和说明
`StrBuilder()` 构造
`StrBuilder(CharSequence... strs)` 构造
`StrBuilder(int initialCapacity)` 构造

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`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()` 重置并返回生成的字符串

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

从接口继承的方法 java.lang.CharSequence
chars, codePoints

- 字段详细资料
  - DEFAULT_CAPACITY
```
public static final int DEFAULT_CAPACITY
```
    默认容量
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - StrBuilder
```
public StrBuilder()
```
    构造
  - StrBuilder
```
public StrBuilder(int initialCapacity)
```
    构造
    
    参数:
    
    initialCapacity - 初始容量
  - StrBuilder
```
public StrBuilder(CharSequence... strs)
```
    构造
    
    参数:
    
    strs - 初始字符串
    
    从以下版本开始:
    
    4.0.1
- 方法详细资料
  - create
```
public static StrBuilder create()
```
    创建字符串构建器
    
    返回:
    
    StrBuilder
  - create
```
public static StrBuilder create(int initialCapacity)
```
    创建字符串构建器
    
    参数:
    
    initialCapacity - 初始容量
    
    返回:
    
    StrBuilder
  - create
```
public static StrBuilder create(CharSequence... strs)
```
    创建字符串构建器
    
    参数:
    
    strs - 初始字符串
    
    返回:
    
    StrBuilder
    
    从以下版本开始:
    
    4.0.1
  - append
```
public StrBuilder append(Object obj)
```
    追加对象，对象会被转换为字符串
    
    参数:
    
    obj - 对象
    
    返回:
    
    this
  - append
```
public StrBuilder append(char c)
```
    追加一个字符
    
    指定者:
    
    append 在接口中 Appendable
    
    参数:
    
    c - 字符
    
    返回:
    
    this
  - append
```
public StrBuilder append(char[] src)
```
    追加一个字符数组
    
    参数:
    
    src - 字符数组
    
    返回:
    
    this
  - append
```
public StrBuilder append(char[] src,
                         int srcPos,
                         int length)
```
    追加一个字符数组
    
    参数:
    
    src - 字符数组
    
    srcPos - 开始位置（包括）
    
    length - 长度
    
    返回:
    
    this
  - append
```
public StrBuilder append(CharSequence csq)
```
    指定者:
    
    append 在接口中 Appendable
  - append
```
public StrBuilder append(CharSequence csq,
                         int start,
                         int end)
```
    指定者:
    
    append 在接口中 Appendable
  - insert
```
public StrBuilder insert(int index,
                         Object obj)
```
    追加对象，对象会被转换为字符串
    
    参数:
    
    index - 插入位置
    
    obj - 对象
    
    返回:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char c)
```
    插入指定字符
    
    参数:
    
    index - 位置
    
    c - 字符
    
    返回:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char[] src)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 插入位置
    
    src - 源数组
    
    返回:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         char[] src,
                         int srcPos,
                         int length)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 插入位置
    
    src - 源数组
    
    srcPos - 位置
    
    length - 长度
    
    返回:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         CharSequence csq)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 位置
    
    csq - 字符串
    
    返回:
    
    this
  - insert
```
public StrBuilder insert(int index,
                         CharSequence csq,
                         int start,
                         int end)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 位置
    
    csq - 字符串
    
    start - 字符串开始位置（包括）
    
    end - 字符串结束位置（不包括）
    
    返回:
    
    this
  - getChars
```
public StrBuilder getChars(int srcBegin,
                           int srcEnd,
                           char[] dst,
                           int dstBegin)
```
    将指定段的字符列表写出到目标字符数组中
    
    参数:
    
    srcBegin - 起始位置（包括）
    
    srcEnd - 结束位置（不包括）
    
    dst - 目标数组
    
    dstBegin - 目标起始位置（包括）
    
    返回:
    
    this
  - hasContent
```
public boolean hasContent()
```
    是否有内容
    
    返回:
    
    是否有内容
  - isEmpty
```
public boolean isEmpty()
```
    是否为空
    
    返回:
    
    是否为空
  - clear
```
public StrBuilder clear()
```
    删除全部字符，位置归零
    
    返回:
    
    this
  - reset
```
public StrBuilder reset()
```
    删除全部字符，位置归零
    
    返回:
    
    this
  - delTo
```
public StrBuilder delTo(int newPosition)
```
    删除到指定位置
    如果新位置小于等于0，则删除全部
    
    参数:
    
    newPosition - 新的位置，不包括这个位置
    
    返回:
    
    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都位于长度区间内，删除这段内容（内存拷贝）
 
```
    参数:
    
    start - 开始位置，负数按照0处理（包括）
    
    end - 结束位置，超出最大长度按照最大长度处理（不包括）
    
    返回:
    
    this
    
    抛出:
    
    StringIndexOutOfBoundsException - 当start > end抛出此异常
  - toString
```
public String toString(boolean isReset)
```
    生成字符串
    
    参数:
    
    isReset - 是否重置，重置后相当于空的构建器
    
    返回:
    
    生成的字符串
  - toStringAndReset
```
public String toStringAndReset()
```
    重置并返回生成的字符串
    
    返回:
    
    字符串
  - toString
```
public String toString()
```
    生成字符串
    
    指定者:
    
    toString 在接口中 CharSequence
    
    覆盖:
    
    toString 在类中 Object
  - length
```
public int length()
```
    指定者:
    
    length 在接口中 CharSequence
  - charAt
```
public char charAt(int index)
```
    指定者:
    
    charAt 在接口中 CharSequence
  - subSequence
```
public CharSequence subSequence(int start,
                                int end)
```
    指定者:
    
    subSequence 在接口中 CharSequence
  - subString
```
public String subString(int start)
```
    返回自定段的字符串
    
    参数:
    
    start - 开始位置（包括）
    
    返回:
    
    this
  - subString
```
public String subString(int start,
                        int end)
```
    返回自定段的字符串
    
    参数:
    
    start - 开始位置（包括）
    
    end - 结束位置（不包括）
    
    返回:
    
    this

类 StrBuilder

字段概要

构造器概要

方法概要

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

从接口继承的方法 java.lang.CharSequence

字段详细资料

DEFAULT_CAPACITY

构造器详细资料

StrBuilder

StrBuilder

StrBuilder

方法详细资料

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