compact1, compact2, compact3

java.lang

Class StringBuilder

java.lang.Object

java.lang.StringBuilder

All Implemented Interfaces:

Serializable， Appendable， CharSequence

public final class StringBuilder
extends Object
implements Serializable, CharSequence

一个可变的字符序列。这个类提供了一个API兼容 StringBuffer，但无法保证同步。本课程是专为使用作为一个下降的替代 StringBuffer在地方的字符串缓冲区被一个线程使用（一般情况下）。在可能的情况下，建议优先使用这类 StringBuffer它将在大多数实现更快。

在StringBuilder的主营业务是append和insert方法的重载，以便接受任何数据类型。每个有效地将一个给定的数据到一个字符串，然后追加或插入字符串的字符的字符串生成器。的append方法总是说这些人物在生成器的结束；的insert方法添加字符在指定点。

例如，如果z指字符串生成器对象的当前内容是“start”，然后调用方法z.append("le")会导致字符串生成器包含“startle”，而z.insert(4, "le")会改变字符串生成器包含“starlet”。

一般来说，如果某人是一个StringBuilder实例，然后sb.append(x)具有相同的效果sb.insert(sb.length(), x)。

每一个字符串生成器都有一个容量。只要字符串生成器中包含的字符序列的长度不超过容量，就没有必要分配一个新的内部缓冲区。如果内部缓冲区溢出，则自动作出较大的。

StringBuilder不安全的实例用于多个线程。如果需要同步然后建议StringBuffer可用。

除非另有说明，通过null争论这类构造函数或方法会导致一个NullPointerException被。

从以下版本开始：

一点五

另请参见：

StringBuffer， String， Serialized Form

构造方法摘要

构造方法

Constructor and Description
StringBuilder() 构造一个没有字符的字符串生成器，并构造了16个字符的初始容量。
StringBuilder(CharSequence seq) 构建一个包含指定的 CharSequence相同字符的字符串生成器。
StringBuilder(int capacity) 构造一个字符串生成器没有字符和一个初始容量的 capacity参数指定。
StringBuilder(String str) 构造一个初始化为指定字符串的内容的字符串生成器。

方法摘要

Modifier and Type	Method and Description
StringBuilder	append(boolean b) 追加的 boolean参数序列的字符串表示形式。
StringBuilder	append(char c) 追加的 char争论这个序列的字符串表示形式。
StringBuilder	append(char[] str) 追加的 char数组参数这一序列的字符串表示形式。
StringBuilder	append(char[] str, int offset, int len) 追加一个阵的 char数组参数这一序列的字符串表示形式。
StringBuilder	append(CharSequence s) 将指定的字符序列，这 Appendable。
StringBuilder	append(CharSequence s, int start, int end) 添加一个序列指定的 CharSequence这个序列。
StringBuilder	append(double d) 追加的 double争论这个序列的字符串表示形式。
StringBuilder	append(float f) 追加的 float争论这个序列的字符串表示形式。
StringBuilder	append(int i) 追加的 int争论这个序列的字符串表示形式。
StringBuilder	append(long lng) 追加的 long争论这个序列的字符串表示形式。
StringBuilder	append(Object obj) 追加的 Object参数的字符串表示形式。
StringBuilder	append(String str) 将指定的字符串，这个字符序列。
StringBuilder	append(StringBuffer sb) 将指定的 StringBuffer这个序列。
StringBuilder	appendCodePoint(int codePoint) 追加的 codePoint争论这个序列的字符串表示形式。
int	capacity() 返回当前容量。
char	charAt(int index) 返回指定索引在这个序列的 char价值。
int	codePointAt(int index) 返回字符（Unicode代码点）在指定的索引。
int	codePointBefore(int index) 返回字符（Unicode代码点）在指定的索引。
int	codePointCount(int beginIndex, int endIndex) 返回此序列指定的文本范围的Unicode代码点的数量。
StringBuilder	delete(int start, int end) 删除的字符在字符串序列分析。
StringBuilder	deleteCharAt(int index) 删除 char在指定的位置在这个序列。
void	ensureCapacity(int minimumCapacity) 确保容量至少等于指定的最小值。
void	getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) 从这个序列的字符复制到目标字符数组 dst。
int	indexOf(String str) 返回指数在这个字符串指定的子字符串中第一个出现的。
int	indexOf(String str, int fromIndex) 返回此字符串的指定子字符串中第一个出现在索引中，从指定索引处开始。
StringBuilder	insert(int offset, boolean b) 插入的 boolean参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, char c) 插入的 char参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, char[] str) 插入的 char数组参数的字符串表示形式进入这个序列。
StringBuilder	insert(int index, char[] str, int offset, int len) 插入子的 str数组参数的字符串表示形式进入这个序列。
StringBuilder	insert(int dstOffset, CharSequence s) 插入指定的 CharSequence这个序列。
StringBuilder	insert(int dstOffset, CharSequence s, int start, int end) 插入序列指定的 CharSequence这个序列。
StringBuilder	insert(int offset, double d) 插入的 double参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, float f) 插入的 float参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, int i) 插入第二 int参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, long l) 插入的 long参数的字符串表示形式进入这个序列。
StringBuilder	insert(int offset, Object obj) 插入的 Object参数的字符串表示形式到这个字符序列。
StringBuilder	insert(int offset, String str) 将字符串插入到这个字符序列中。
int	lastIndexOf(String str) 返回指数在这个字符串的指定子字符串最右边的发生。
int	lastIndexOf(String str, int fromIndex) 返回指数在这个字符串的指定子字符串中最后出现。
int	length() 返回长度（字符数）。
int	offsetByCodePoints(int index, int codePointOffset) 返回指数在这个序列，从给定的 codePointOffset代码点 index偏移。
StringBuilder	replace(int start, int end, String str) 在一个字符串中替换指定的 String字符这个序列的特征。
StringBuilder	reverse() 使这个字符序列被序列的反转所取代。
void	setCharAt(int index, char ch) 指定索引处的字符设置为 ch。
void	setLength(int newLength) 设置字符序列的长度。
CharSequence	subSequence(int start, int end) 返回一个新的字符序列的子序列。
String	substring(int start) 返回一个包含目前包含此字符序列的子序列的新特点 String。
String	substring(int start, int end) 返回一个包含目前包含在这个序列的子序列特征的新 String。
String	toString() 返回表示该序列中的数据的字符串。
void	trimToSize() 试图减少字符序列的存储。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

charAt, chars, codePoints, length, subSequence

Constructor Detail

StringBuilder

public StringBuilder()

构造一个没有字符的字符串生成器，并构造了16个字符的初始容量。

StringBuilder

public StringBuilder(int capacity)

构造一个字符串生成器没有字符和一个初始容量的 capacity参数指定。

参数

capacity -初始容量。

异常

NegativeArraySizeException -如果 capacity参数小于 0。

StringBuilder

public StringBuilder(String str)

构造一个初始化为指定字符串的内容的字符串生成器。该字符串生成器的初始容量是 16加字符串的长度。

参数

str -缓冲区的初始内容。

StringBuilder

public StringBuilder(CharSequence seq)

构建一个包含指定的 CharSequence相同字符的字符串生成器。该字符串生成器的初始容量是 16加的 CharSequence实参的长度。

参数

seq序列的复制。

方法详细信息

append

public StringBuilder append(Object obj)

追加的 Object参数的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(Object)字符串和字符串，然后appended这个字符序列的特征。

参数

obj - Object。

结果

此对象的引用。

append

public StringBuilder append(String str)

将指定的字符串，这个字符序列。

String争论的人物加入，在秩序，以论据的长度增加，该序列的长度。如果str是null，然后四个字"null"追加。

让nulln是长度该字符序列在append方法之前执行。然后在新的字符序列指数nullk字符等于字符在字符序列nullk旧指数，如果nullk小于nulln；否则，它等于字符在参数str指数nullk-n。

参数

str -一个字符串。

结果

此对象的引用。

append

public StringBuilder append(StringBuffer sb)

将指定的 StringBuffer这个序列。

StringBuffer争论的人物加入，为了这个序列，以论据的长度增加，该序列的长度。如果sb是null，然后四个字"null"附加到该序列。

让nulln是长度该字符序列在append方法之前执行。然后在新的字符序列指数nullk字符等于字符在字符序列nullk旧指数，如果nullk小于nulln；否则，它等于字符在参数sb指数nullk-n。

参数

sb - StringBuffer追加。

结果

此对象的引用。

append

public StringBuilder append(CharSequence s)

从接口复制的描述： Appendable

将指定的字符序列，这 Appendable。

根据这类实现字符序列csq，整个序列可能不追加。例如，如果csq是CharBuffer然后后续追加的缓冲区的位置和范围定义。

Specified by:

append 接口 Appendable

参数

s -字符序列添加。如果 csq是 null，然后四个字 "null"附加到这可追加。

结果

一提到这个 Appendable

append

public StringBuilder append(CharSequence s,
                            int start,
                            int end)

添加一个序列指定的 CharSequence这个序列。

争论的s特征，从指数start，附加的内容，以便该序列到（独家）指数end。该序列的长度增加到end - start价值。

让nulln是长度该字符序列在append方法之前执行。然后在这个字符序列指数nullk性格变得相等的字符在这个序列中的索引nullk，如果nullk小于nulln；否则，它等于字符索引nullk + start-n争论中s。

如果s是null，那么这个方法附加字符如果参数是一个序列包含四个字符"null"。

Specified by:

append 接口 Appendable

参数

s序列的追加。

start的起始索引的顺序要追加。

end -子序列的终点指标是附加。

结果

此对象的引用。

异常

IndexOutOfBoundsException -如果 start是负的，或 start大于 end或 end大于 s.length()

append

public StringBuilder append(char[] str)

追加的 char数组参数这一序列的字符串表示形式。

数组参数的字符被添加，以顺序，到这个序列的内容。这个序列的长度增加了参数的长度。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(char[])字符串和字符串，然后appended这个字符序列的特征。

参数

str -人物要追加。

结果

此对象的引用。

append

public StringBuilder append(char[] str,
                            int offset,
                            int len)

追加一个阵的 char数组参数这一序列的字符串表示形式。

char阵列的str特征，从指数offset，追加，为了对这个序列的内容。通过len价值这个序列的长度增加。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(char[],int,int)字符串和字符串，然后appended这个字符序列的特征。

参数

str -人物要追加。

offset -第一 char追加指标。

len - chars数量追加。

结果

此对象的引用。

异常

IndexOutOfBoundsException -如果 offset < 0或 len < 0或 offset+len > str.length

append

public StringBuilder append(boolean b)

追加的 boolean参数序列的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(boolean)字符串和字符串，然后appended这个字符序列的特征。

参数

b - boolean。

结果

此对象的引用。

append

public StringBuilder append(char c)

追加的 char争论这个序列的字符串表示形式。

该参数被添加到该序列的内容中。通过1这个序列的长度增加。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(char)字符串，在字符串进行appended这个字符序列的特征。

Specified by:

append 接口 Appendable

参数

c - char。

结果

此对象的引用。

append

public StringBuilder append(int i)

追加的 int争论这个序列的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(int)字符串和字符串，然后appended这个字符序列的特征。

参数

i - int。

结果

此对象的引用。

append

public StringBuilder append(long lng)

追加的 long争论这个序列的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(long)字符串和字符串，然后appended这个字符序列的特征。

参数

lng - long。

结果

此对象的引用。

append

public StringBuilder append(float f)

追加的 float争论这个序列的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(float)字符串和字符串，然后appended这个字符序列的特征。

参数

f - float。

结果

此对象的引用。

append

public StringBuilder append(double d)

追加的 double争论这个序列的字符串表示形式。

总的效果是完全一样，如果参数进行转换的方法String.valueOf(double)字符串和字符串，然后appended这个字符序列的特征。

参数

d - double。

结果

此对象的引用。

appendCodePoint

public StringBuilder appendCodePoint(int codePoint)

追加的 codePoint争论这个序列的字符串表示形式。

该参数被添加到该序列的内容中。通过Character.charCount(codePoint)这个序列的长度增加。

总的效果是完全一样，如果参数转换为通过在阵列进行appended这个字符序列特征的方法Character.toChars(int)一char阵列。

参数

codePoint - Unicode代码点

结果

此对象的引用。

从以下版本开始：

一点五

delete

public StringBuilder delete(int start,
                            int end)

删除的字符在字符串序列分析。子字符串从指定的 start延伸特征的指标 end - 1或序列的结束，如果没有这样的人物存在。如果 start等于 end，不进行任何更改。

参数

start开始的指标，包括。

end的结局指标，独家。

结果

这个对象。

异常

StringIndexOutOfBoundsException -如果 start是负的，大于 length()，或大于 end。

deleteCharAt

public StringBuilder deleteCharAt(int index)

删除 char在指定的位置在这个序列。这个顺序是缩短一 char。

注：如果给定索引处的字符是一个补充字符，则此方法不会删除整个字符。如果正确处理补充字符需要，确定通过调用Character.charCount(thisSequence.codePointAt(index))去除chars数量，在thisSequence这个序列。

参数

index指标 char删除

结果

这个对象。

异常

StringIndexOutOfBoundsException -如果 index阴性或大于或等于 length()。

replace

public StringBuilder replace(int start,
                             int end,
                             String str)

在一个字符串中替换指定的 String字符这个序列的特征。子字符串从指定的 start延伸特征的指标 end - 1或序列的结束，如果没有这样的人物存在。首先在子串字符删除，然后指定 String插在 start。（这个顺序将加长以容纳指定的字符串，如果必要的。）

参数

start开始的指标，包括。

end的结局指标，独家。

str字符串，将取代以前的内容。

结果

这个对象。

异常

StringIndexOutOfBoundsException -如果 start是负的，大于 length()，或大于 end。

insert

public StringBuilder insert(int index,
                            char[] str,
                            int offset,
                            int len)

插入子的 str数组参数的字符串表示形式进入这个序列。子阵开始在指定的 offset延伸 len chars，子阵字符插入序列在指示位置 index。通过 len chars这个序列的长度增加。

参数

index位置在其中插入子阵。

str - char阵列。

offset -子阵的第一 char要插入索引。

len在子 chars数被插入。

结果

这个对象

异常

StringIndexOutOfBoundsException -如果 index为负数或大于 length()，或 offset或 len是负面的，或 (offset+len)大于 str.length。

insert

public StringBuilder insert(int offset,
                            Object obj)

插入的 Object参数的字符串表示形式到这个字符序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(Object)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

obj - Object。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            String str)

将字符串插入到这个字符序列中。

String论点的字符插入，为了在指定的偏移到这个序列，移动任何字符上的最初位置参数长度的增加，该序列的长度。如果str是null，然后四个字"null"插入序列。

在新的字符序列指数nullk字符等于：

• 在旧的字符序列的指数nullk字符，如果nullk小于offset
• 在参数str指数nullk-offset字符，如果nullk不小于offset但小于offset+str.length()
• 在旧的字符序列的指数nullk-str.length()字符，如果nullk不小于offset+str.length()

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

str -一个字符串。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            char[] str)

插入的 char数组参数的字符串表示形式进入这个序列。

该数组参数字符插入这个序列的内容在指示位置offset。以论据序列长度长度增加。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(char[])字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

str -字符数组。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int dstOffset,
                            CharSequence s)

插入指定的 CharSequence这个序列。

CharSequence论点的字符插入，为了在指定的偏移到这个序列，移动任何字符原来上面位置和以论据s的长度的增加，该序列的长度

这种方法的结果是完全一样，如果它是一个调用该对象的insert（dstoffset，S 0，S length()）方法。

如果s是null，然后四个字"null"插入序列。

参数

dstOffset -偏移。

s的序列被插入

结果

此对象的引用。

异常

IndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int dstOffset,
                            CharSequence s,
                            int start,
                            int end)

插入序列指定的 CharSequence这个序列。

这个论点的顺序s通过start和end指定插入，顺序，在指定的目的地偏移到这个序列，移动任何字符最初以上位置。这个序列的长度增加了end - start。

在这个序列中的索引nullk字符等于：

• 在这个序列中的索引nullk字符，如果nullk小于dstOffset
• 在参数s指数nullk+start-dstOffset字符，如果nullk大于或等于dstOffset但小于dstOffset+end-start
• 在这个序列中的索引nullk-(end-start)字符，如果nullk大于或等于dstOffset+end-start

的dstOffset参数必须大于或等于0，且小于或等于该序列的length。

start参数必须是非负的，且不大于end。

最后的论点必须大于或等于start，且小于或等于S的长度。

如果s是null，那么这种方法插入字符如果参数是一个序列包含四个字符"null"。

参数

dstOffset -在这个序列的偏。

s的序列被插入。

start的起始索引的顺序被插入。

end -子序列的终点指标是插入。

结果

此对象的引用。

异常

IndexOutOfBoundsException -如果 dstOffset为负数或大于 this.length()，或 start或 end是负面的，或 start大于 end或 end大于 s.length()

insert

public StringBuilder insert(int offset,
                            boolean b)

插入的 boolean参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(boolean)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

b - boolean。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            char c)

插入的 char参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(char)字符串，在字符串进行inserted到这个字符序列在显示的字符偏移量。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

c - char。

结果

此对象的引用。

异常

IndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            int i)

插入第二 int参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(int)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

i - int。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            long l)

插入的 long参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(long)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

l - long。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            float f)

插入的 float参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(float)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

f - float。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

insert

public StringBuilder insert(int offset,
                            double d)

插入的 double参数的字符串表示形式进入这个序列。

总的效果是完全一样，如果第二个参数进行转换的方法String.valueOf(double)字符串和字符串，然后inserted到这个字符序列在显示偏移的特点。

的offset参数必须大于或等于0，且小于或等于该序列的length。

参数

offset -偏移。

d - double。

结果

此对象的引用。

异常

StringIndexOutOfBoundsException如果偏移是无效的。

indexOf

public int indexOf(String str)

返回指数在这个字符串指定的子字符串中第一个出现的。返回的整数的最小值nullk这样：

 this.toString().startsWith(str, <i>k</i>)
 

是 true。

参数

str任何字符串。

结果

如果字符串参数发生在该对象的字符串，然后对第一个子字符串的第一个字符的索引返回；如果它不发生 -1作为子字符串，返回。

indexOf

public int indexOf(String str,
                   int fromIndex)

返回此字符串的指定子字符串中第一个出现在索引中，从指定索引处开始。返回的整数是其中最小值 k：

     k >= Math.min(fromIndex, this.length()) &&
                   this.toString().startsWith(str, k)
 

如果nullk没有存在的价值，然后返回- 1。

参数

str -要搜索的字符串。

fromIndex -从开始搜索指数。

结果

这串指定的子字符串中第一个出现在索引中，从指定索引处开始。

lastIndexOf

public int lastIndexOf(String str)

返回指数在这个字符串的指定子字符串最右边的发生。最右边的空字符串“”是发生在指标值 this.length()。返回的指标是这样的，

 this.toString().startsWith(str, k)
 

是真正的最大的价值nullk。

参数

str -子串搜索。

结果

如果字符串中出现一次或多次在该对象的字符串，然后对最后一个这样的子串的第一个字符的索引返回。如果它不发生 -1作为子字符串，返回。

lastIndexOf

public int lastIndexOf(String str,
                       int fromIndex)

返回指数在这个字符串的指定子字符串中最后出现。返回的整数的最大值nullk这样：

     k <= Math.min(fromIndex, this.length()) &&
                   this.toString().startsWith(str, k)
 

如果nullk没有存在的价值，然后返回- 1。

参数

str -子串搜索。

fromIndex -开始搜索指数。

结果

这一系列的指定子字符串中最后出现在索引。

reverse

public StringBuilder reverse()

使这个字符序列被序列的反转所取代。如果在序列中包含任何代理对，这些都被视为反向操作的单个字符。因此，在高、低代理项顺序从来没有改变。让nulln是该字符序列的字符长度（不 char值的长度）只是之前的 reverse方法执行。然后在新的字符序列指数nullk字符等于字符在字符序列的指数nulln-k-1老。

值得注意的是反向操作可能导致产生代理对被代理人和代理人未配对的低高术前。例如，扭转“udc00 \ ud800”产生“ud800 \ udc00”是一种有效的代理项对。

结果

此对象的引用。

toString

public String toString()

返回表示该序列中的数据的字符串。一个新的 String对象被初始化为包含目前代表这个对象的字符序列。这 String然后返回。这个序列的后续变化不影响内容的 String。

Specified by:

toString 接口 CharSequence

结果

此序列的字符串表示。

length

public int length()

返回长度（字符数）。

Specified by:

length 接口 CharSequence

结果

当前由该对象表示的字符的序列的长度

capacity

public int capacity()

返回当前容量。容量是可用于新插入的字符的存储量，超出该分配将发生。

结果

目前的能力

ensureCapacity

public void ensureCapacity(int minimumCapacity)

确保容量至少等于指定的最小值。如果当前容量小于参数，那么一个新的内部数组将被分配更大的容量。新的容量较大的是：

• 争论的minimumCapacity。
• 两次旧的能力，加上2。

如果 minimumCapacity争论是非，这方法不采取任何行动，而只是返回。请注意，在此对象上的后续操作可以减少下面所请求的实际容量。

参数

minimumCapacity -所需的最小容量。

trimToSize

public void trimToSize()

试图减少字符序列的存储。如果缓冲区大于必要保持其当前的字符序列，那么它可能会调整到更加节省空间。调用此方法，但不要求，影响价值的后续调用方法返回的 capacity()。

setLength

public void setLength(int newLength)

设置字符序列的长度。该序列被改变为一个新的字符序列，其长度由参数指定。对于每一个非负指数nullk小于 newLength，在新字符序列指数nullk字符是在旧的序列索引nullk字符如果nullk小于旧的字符序列的长度相同；否则，它是空字符 '\u0000'。换句话说，如果 newLength参数小于当前的长度，长度变为指定长度。

如果newLength参数大于或等于当前长度，足够的空字符（'\u0000'）加入，成为newLength参数长度。

的newLength参数必须大于或等于0。

参数

newLength -新的长度

异常

IndexOutOfBoundsException -如果 newLength参数为负。

charAt

public char charAt(int index)

返回指定索引在这个序列的 char价值。第一 char值在指数 0，在指数 1下，等等，作为数组索引。

指标参数必须大于或等于0，小于该序列的长度。

如果由索引指定的char值是一个surrogate，代孕的返回值。

Specified by:

charAt 接口 CharSequence

参数

index -所需的 char价值指数。

结果

指定索引处的 char价值。

异常

IndexOutOfBoundsException -如果 index阴性或大于或等于 length()。

codePointAt

public int codePointAt(int index)

返回字符（Unicode代码点）在指定的索引。该指数是指 char值（Unicode代码单元）和 0到 length() - 1范围。

如果在给定的索引指定的char值在高代理范围，以下指数小于该序列的长度，并在下列指标的char值是低代理范围，那么这个代理对相应的附加码点返回。否则，给定索引处的char返回值。

参数

index -指数的 char值

结果

在 index字符的码值

异常

IndexOutOfBoundsException -如果 index参数为负或不低于该序列的长度。

codePointBefore

public int codePointBefore(int index)

返回字符（Unicode代码点）在指定的索引。该指数是指 char值（Unicode代码单元）和 1到 length()范围。

如果在(index - 1)的char值是低代理范围，(index - 2)不是消极的，并在(index - 2)的char值在高代理范围，然后代理项对的辅助码位的值被返回。如果在index - 1的char值是一个未成对的低或高的代孕代孕，代孕的返回值。

参数

index跟踪代码点应该返回的索引

结果

Unicode代码点的值在给定的索引。

异常

IndexOutOfBoundsException -如果 index参数小于1或大于该序列的长度。

codePointCount

public int codePointCount(int beginIndex,
                          int endIndex)

返回此序列指定的文本范围的Unicode代码点的数量。文本范围从指定的 beginIndex延伸在指数 endIndex - 1的 char。这样的长度（在 chars）的文本范围 endIndex-beginIndex。成对的代理人在该序列编码点各算一个。

参数

beginIndex -索引的文本范围的第一个 char。

endIndex -文本范围的最后 char后指数。

结果

在指定的文本范围的Unicode代码点的数量

异常

IndexOutOfBoundsException -如果 beginIndex是负的，或 endIndex大于该序列的长度，或 beginIndex大于 endIndex。

offsetByCodePoints

public int offsetByCodePoints(int index,
                              int codePointOffset)

返回指数在这个序列，从给定的 codePointOffset代码点 index偏移。不成对的代理人在文本范围的 index和 codePointOffset计数作为一个码点每。

参数

index将抵消指数

codePointOffset -偏移代码点

结果

在此序列中的索引

异常

IndexOutOfBoundsException -如果 index阴性或大于该序列的长度，或者如果 codePointOffset是积极的，随后开始 index少于 codePointOffset代码点，或者如果 codePointOffset是负的，在 index少于 codePointOffset代码点的绝对值序列。

getChars

public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)

从这个序列的字符复制到目标字符数组 dst。要复制的第一个字符是在指数 srcBegin；要复制的最后一个字符是在指数 srcEnd-1。要复制的字符数 srcEnd-srcBegin。字符复制到 dst子数组的索引 dstBegin开始和结束索引：

 dstbegin + (srcEnd-srcBegin) - 1
 

参数

srcBegin启动复制这个偏移。

srcEnd停止复制这个偏移。

dst -数组数据复制到。

dstBegin偏移到 dst。

异常

IndexOutOfBoundsException -如果任何以下是真实的：

• srcBegin是负的
• dstBegin是负的
• 的srcBegin参数大于srcEnd论点。
• srcEnd大于this.length()。
• dstBegin+srcEnd-srcBegin大于dst.length

setCharAt

public void setCharAt(int index,
                      char ch)

指定索引处的字符设置为 ch。这个序列的改变代表了一种新的字符序列，是旧的字符序列相同，除了它包含的字符位置 index ch。

指标参数必须大于或等于0，小于该序列的长度。

参数

index -人物修改索引。

ch -新特征。

异常

IndexOutOfBoundsException -如果 index阴性或大于或等于 length()。

substring

public String substring(int start)

返回一个包含目前包含此字符序列的子序列的新特点 String。子字符串的指定索引处开始，延伸到这个序列结束。

参数

start开始的指标，包括。

结果

新字符串。

异常

StringIndexOutOfBoundsException -如果 start小于零或大于该物体的长度。

subSequence

public CharSequence subSequence(int start,
                                int end)

返回一个新的字符序列的子序列。

此方法的调用

 sb.subSequence(begin, end)

表现一样，调用

 sb.substring(begin, end)

提供此方法是使这类可以实现接口的 CharSequence。

Specified by:

subSequence 接口 CharSequence

参数

start的起始索引，包括。

end结束的指标，独家。

结果

指定的子序列。

异常

IndexOutOfBoundsException -如果 start或 end是负面的，如果 end大于 length()，或者如果 start大于 end

substring

public String substring(int start,
                        int end)

返回一个包含目前包含在这个序列的子序列特征的新 String。子字符串从指定的 start延伸在指数 end - 1字符。

参数

start开始的指标，包括。

end的结局指标，独家。

结果

新字符串。

异常

StringIndexOutOfBoundsException -如果 start或 end负值或大于 length()，或 start大于 end。