StringBuilder (jarvis-tool-core 1.0.3.RELEASE API)

java.lang.Object
- com.github.jarvisframework.tool.core.text.StringBuilder

所有已实现的接口:

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

从以下版本开始:

1.0, 2020-07-29 18:27:37

作者:

Doug Wang

另请参阅:

序列化表格

字段概要

字段
限定符和类型	字段和说明
`static int`	`DEFAULT_CAPACITY` 默认容量
`private int`	`position` 当前指针位置，或者叫做已经加入的字符数，此位置总在最后一个字符之后
`private static long`	`serialVersionUID`
`private char[]`	`value` 存放的字符数组

构造器概要

构造器
构造器和说明

StringBuilder()
构造

StringBuilder(CharSequence... strs)
构造

StringBuilder(int initialCapacity)
构造

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

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`StringBuilder`	`append(char c)` 追加一个字符
`StringBuilder`	`append(char[] src)` 追加一个字符数组
`StringBuilder`	`append(char[] src, int srcPos, int length)` 追加一个字符数组
`StringBuilder`	`append(CharSequence csq)`
`StringBuilder`	`append(CharSequence csq, int start, int end)`
`StringBuilder`	`append(Object obj)` 追加对象，对象会被转换为字符串
`char`	`charAt(int index)`
`StringBuilder`	`clear()` 删除全部字符，位置归零
`static StringBuilder`	`create()` 创建字符串构建器
`static StringBuilder`	`create(CharSequence... strs)` 创建字符串构建器
`static StringBuilder`	`create(int initialCapacity)` 创建字符串构建器
`StringBuilder`	`del(int start, int end)` 删除指定长度的字符，规则如下： 1、end大于等于最大长度，结束按照最大长度计算，相当于删除start之后虽有部分（性能最好） 2、end小于start时，抛出StringIndexOutOfBoundsException 3、start小于0 按照0处理 4、start等于end不处理 5、start和end都位于长度区间内，删除这段内容（内存拷贝）
`StringBuilder`	`delTo(int newPosition)` 删除到指定位置如果新位置小于等于0，则删除全部
`private void`	`ensureCapacity(int minimumCapacity)` 确认容量是否够用，不够用则扩展容量
`private void`	`expandCapacity(int minimumCapacity)` 扩展容量首先对容量进行二倍扩展，如果小于最小容量，则扩展为最小容量
`StringBuilder`	`getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)` 将指定段的字符列表写出到目标字符数组中
`boolean`	`hasContent()` 是否有内容
`StringBuilder`	`insert(int index, char c)` 插入指定字符
`StringBuilder`	`insert(int index, char[] src)` 指定位置插入数据如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StringBuilder`	`insert(int index, char[] src, int srcPos, int length)` 指定位置插入数据如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StringBuilder`	`insert(int index, CharSequence csq)` 指定位置插入字符串的某个部分如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StringBuilder`	`insert(int index, CharSequence csq, int start, int end)` 指定位置插入字符串的某个部分如果插入位置为当前位置，则定义为追加如果插入位置大于当前位置，则中间部分补充空格
`StringBuilder`	`insert(int index, Object obj)` 追加对象，对象会被转换为字符串
`boolean`	`isEmpty()` 是否为空
`int`	`length()`
`private void`	`moveDataAfterIndex(int index, int length)` 指定位置之后的数据后移指定长度
`StringBuilder`	`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()` 重置并返回生成的字符串
`private static int`	`totalLength(CharSequence... strs)` 给定字符串数组的总长度 null字符长度定义为0

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

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

- 字段详细资料
  - serialVersionUID
```
private static final long serialVersionUID
```
    另请参阅:
    
    常量字段值
  - DEFAULT_CAPACITY
```
public static final int DEFAULT_CAPACITY
```
    默认容量
    
    另请参阅:
    
    常量字段值
  - value
```
private char[] value
```
    存放的字符数组
  - position
```
private int position
```
    当前指针位置，或者叫做已经加入的字符数，此位置总在最后一个字符之后
- 构造器详细资料
  - StringBuilder
```
public StringBuilder()
```
    构造
  - StringBuilder
```
public StringBuilder(int initialCapacity)
```
    构造
    
    参数:
    
    initialCapacity - 初始容量
  - StringBuilder
```
public StringBuilder(CharSequence... strs)
```
    构造
    
    参数:
    
    strs - 初始字符串
    
    从以下版本开始:
    
    4.0.1
- 方法详细资料
  - create
```
public static StringBuilder create()
```
    创建字符串构建器
    
    返回:
    
    StringBuilder
  - create
```
public static StringBuilder create(int initialCapacity)
```
    创建字符串构建器
    
    参数:
    
    initialCapacity - 初始容量
    
    返回:
    
    StringBuilder
  - create
```
public static StringBuilder create(CharSequence... strs)
```
    创建字符串构建器
    
    参数:
    
    strs - 初始字符串
    
    返回:
    
    StringBuilder
    
    从以下版本开始:
    
    4.0.1
  - append
```
public StringBuilder append(Object obj)
```
    追加对象，对象会被转换为字符串
    
    参数:
    
    obj - 对象
    
    返回:
    
    this
  - append
```
public StringBuilder append(char c)
```
    追加一个字符
    
    指定者:
    
    append 在接口中 Appendable
    
    参数:
    
    c - 字符
    
    返回:
    
    this
  - append
```
public StringBuilder append(char[] src)
```
    追加一个字符数组
    
    参数:
    
    src - 字符数组
    
    返回:
    
    this
  - append
```
public StringBuilder append(char[] src,
                            int srcPos,
                            int length)
```
    追加一个字符数组
    
    参数:
    
    src - 字符数组
    
    srcPos - 开始位置（包括）
    
    length - 长度
    
    返回:
    
    this
  - append
```
public StringBuilder append(CharSequence csq)
```
    指定者:
    
    append 在接口中 Appendable
  - append
```
public StringBuilder append(CharSequence csq,
                            int start,
                            int end)
```
    指定者:
    
    append 在接口中 Appendable
  - insert
```
public StringBuilder insert(int index,
                            Object obj)
```
    追加对象，对象会被转换为字符串
    
    参数:
    
    index - 插入位置
    
    obj - 对象
    
    返回:
    
    this
  - insert
```
public StringBuilder insert(int index,
                            char c)
```
    插入指定字符
    
    参数:
    
    index - 位置
    
    c - 字符
    
    返回:
    
    this
  - insert
```
public StringBuilder insert(int index,
                            char[] src)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 插入位置
    
    src - 源数组
    
    返回:
    
    this
  - insert
```
public StringBuilder insert(int index,
                            char[] src,
                            int srcPos,
                            int length)
```
    指定位置插入数据
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 插入位置
    
    src - 源数组
    
    srcPos - 位置
    
    length - 长度
    
    返回:
    
    this
  - insert
```
public StringBuilder insert(int index,
                            CharSequence csq)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 位置
    
    csq - 字符串
    
    返回:
    
    this
  - insert
```
public StringBuilder insert(int index,
                            CharSequence csq,
                            int start,
                            int end)
```
    指定位置插入字符串的某个部分
    如果插入位置为当前位置，则定义为追加
    如果插入位置大于当前位置，则中间部分补充空格
    
    参数:
    
    index - 位置
    
    csq - 字符串
    
    start - 字符串开始位置（包括）
    
    end - 字符串结束位置（不包括）
    
    返回:
    
    this
  - getChars
```
public StringBuilder getChars(int srcBegin,
                              int srcEnd,
                              char[] dst,
                              int dstBegin)
```
    将指定段的字符列表写出到目标字符数组中
    
    参数:
    
    srcBegin - 起始位置（包括）
    
    srcEnd - 结束位置（不包括）
    
    dst - 目标数组
    
    dstBegin - 目标起始位置（包括）
    
    返回:
    
    this
  - hasContent
```
public boolean hasContent()
```
    是否有内容
    
    返回:
    
    是否有内容
  - isEmpty
```
public boolean isEmpty()
```
    是否为空
    
    返回:
    
    是否为空
  - clear
```
public StringBuilder clear()
```
    删除全部字符，位置归零
    
    返回:
    
    this
  - reset
```
public StringBuilder reset()
```
    删除全部字符，位置归零
    
    返回:
    
    this
  - delTo
```
public StringBuilder delTo(int newPosition)
```
    删除到指定位置
    如果新位置小于等于0，则删除全部
    
    参数:
    
    newPosition - 新的位置，不包括这个位置
    
    返回:
    
    this
  - del
```
public StringBuilder 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
  - moveDataAfterIndex
```
private void moveDataAfterIndex(int index,
                                int length)
```
    指定位置之后的数据后移指定长度
    
    参数:
    
    index - 位置
    
    length - 位移长度
  - ensureCapacity
```
private void ensureCapacity(int minimumCapacity)
```
    确认容量是否够用，不够用则扩展容量
    
    参数:
    
    minimumCapacity - 最小容量
  - expandCapacity
```
private void expandCapacity(int minimumCapacity)
```
    扩展容量
    首先对容量进行二倍扩展，如果小于最小容量，则扩展为最小容量
    
    参数:
    
    minimumCapacity - 需要扩展的最小容量
  - totalLength
```
private static int totalLength(CharSequence... strs)
```
    给定字符串数组的总长度
    null字符长度定义为0
    
    参数:
    
    strs - 字符串数组
    
    返回:
    
    总长度
    
    从以下版本开始:
    
    4.0.1

类 StringBuilder

字段概要

构造器概要

方法概要

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

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

字段详细资料

serialVersionUID

DEFAULT_CAPACITY

value

position

构造器详细资料

StringBuilder

StringBuilder

StringBuilder

方法详细资料

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

moveDataAfterIndex

ensureCapacity

expandCapacity

totalLength