java.lang.Object
- java.lang.StringBuilder

実装されているすべてのインターフェース

Serializable ， Appendable ， CharSequence ， Comparable<StringBuilder>
```
public final class StringBuilder
extends Object
implements Serializable, Comparable<StringBuilder>, CharSequence
```
可変の文字シーケンス。このクラスは提供するStringBuffer互換性のある API ですが、同期は保証されません。此类设计用作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参数传递给null中のコンストラクタまたはメソッドは、例外のスローを引き起こします。NullPointerException 。

API Note:

StringBuilder实现Comparable但不覆盖equals 。因此， StringBuilder自然順序はequalsと一致しません。如果StringBuilderオブジェクトとして使用StringBuilderのキーまたはSortedMap元素， SortedSet 。见Comparable ， SortedMap ，或SortedSet获取更多信息。

以下のバージョンから：

1.5

另请参见：

StringBuffer ， String ， Serialized Form

コンストラクタの概要

构造方法
构造器	描述
`StringBuilder()`	文字を含まない文字列ビルダーを構築し、初期容量は16文字です。
`StringBuilder(int capacity)`	构造一个字符串构建器，其中没有字符，并且具有 `capacity`パラメータで指定された初期容量。
`StringBuilder(CharSequence seq)`	指定されたものと同じ文字を含む文字列ビルダーを構築します。`CharSequence`同じ文字。
`StringBuilder(String str)`	指定された文字列の内容で初期化された文字列ビルダーを構築します。

メソッドの概要

所有方法インスタンスメソッド具体的な方法
変数と型	方法	描述
`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(double d)`	将 `double`引数の文字列表現をこのシーケンスに追加します。
`StringBuilder`	`append(float f)`	将 `float`引数の文字列表現をこのシーケンスに追加します。
`StringBuilder`	`append(int i)`	将 `int`引数の文字列表現をこのシーケンスに追加します。
`StringBuilder`	`append(long lng)`	将 `long`引数の文字列表現をこのシーケンスに追加します。
`StringBuilder`	`append(CharSequence s)`	指定された文字シーケンスをこの`Appendable` 。
`StringBuilder`	`append(CharSequence s, int start, int end)`	指定された〜を`CharSequence`序列追加到此序列。
`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`值。
`IntStream`	`chars()`	返回 `int`のストリームは、このシーケンス内の`char`值进行零扩展。
`int`	`codePointAt(int index)`	指定されたインデックスの文字（Unicodeコードポイント）を返します。
`int`	`codePointBefore(int index)`	指定されたインデックスの前の文字（Unicodeコードポイント）を返します。
`int`	`codePointCount(int beginIndex, int endIndex)`	このシーケンスの指定されたテキスト範囲内のUnicodeコードポイント数を返します。
`IntStream`	`codePoints()`	このシーケンス内のコードポイント値のストリームを返します。
`int`	`compareTo(StringBuilder another)`	`StringBuilder`字典顺序比较两个 `StringBuilder`实例。
`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 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 dstOffset, CharSequence s)`	指定された〜を`CharSequence`插入此序列。
`StringBuilder`	`insert(int dstOffset, CharSequence s, int start, int end)`	指定された〜を`CharSequence`序列插入此序列。
`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)`	指定された位置からこのシーケンス内のインデックスを返します。`index`偏移 `codePointOffset`代码点。
`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`、このシーケンスに現在含まれている文字の部分シーケンスを含みます。
`void`	`trimToSize()`	文字シーケンス用の記憶容量を削減しようとします。

メソッドを宣言しているクラス java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

メソッドを宣言しているインタフェース java.lang.CharSequence
charAt, chars, codePoints, length, subSequence, toString

- コンストラクタの詳細
  - 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- コピーするシーケンス。
- メソッドの詳細
  - compareTo
```
public int compareTo(StringBuilder another)
```
    StringBuilder字典顺序比较两个StringBuilder实例。该方法遵循CharSequence.compare(this, another)メソッド内で定義されている辞書式比較と同じ規則。
    細かい粒度の、ロケールに依存する文字列比較については、参照してください。Collator 。
    
    Specified by:
    
    compareToインターフェースでComparable<StringBuilder>
    
    参数
    
    another- 比較対象のStringBuilder
    
    结果
    
    值0如果此StringBuilderパラメータとを含むStringBuilder同じ文字シーケンス; 如果此StringBuilder字典顺序小于StringBuilder参数， StringBuilder负整数; 如果此StringBuilder字典顺序大于StringBuilder参数， StringBuilder正整数。
    
    以下のバージョンから：
    
    11
  - append
```
public StringBuilder append(Object obj)
```
    追加Object引数の文字列表現。
    全体の効果はメソッドとString.valueOf(Object)引数を文字列に変換します完全相同、その後、この文字列の文字はappended 。
    
    参数
    
    obj - Object 。
    
    结果
    
    このオブジェクトへの参照。
  - append
```
public StringBuilder append(String str)
```
    指定された文字列をこの文字シーケンスに追加します。
    按顺序附加String引数の文字が追加され、このシーケンスの長さは引数の長さだけ増加します。如果strであるnull ，则附加四个字符"null" 。
    
    设n実行するappendメソッドの前のその文字シーケンスの長さ。如果k小于n ，则新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。kにある文字; 否则，它等于参数str中索引knにある文字。
    
    参数
    
    str- 文字列。
    
    结果
    
    このオブジェクトへの参照。
  - append
```
public StringBuilder append(StringBuffer sb)
```
    指定された〜をStringBuffer追加到此序列。
    StringBufferパラメータの文字は順番にこのシーケンスに追加され、このシーケンスの長さはパラメータの長さだけ増加します。如果sbであるnull ，则将四个字符"null"附加到该序列。
    
    设n実行するappendメソッドの前のその文字シーケンスの長さ。如果k小于n ，则新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。kにある文字; 否则，它等于参数sb中索引knにある文字。
    
    参数
    
    sb- 追加するStringBuffer 。
    
    结果
    
    このオブジェクトへの参照。
  - append
```
public StringBuilder append(CharSequence s)
```
    インターフェースからコピーされた説明：Appendable
    
    指定された文字シーケンスをこのAppendable 。
    根据哪个类实现字符序列csq ，可能不会附加整个序列。例如，如果csqであるCharBuffer，追加されるサブシーケンスは、バッファの位置と制限によって定義されます。
    
    Specified by:
    
    appendインターフェースでAppendable
    
    参数
    
    s- 追加する文字シーケンス。如果csqであるnull ，则四个字符"null"将附加到此Appendable。
    
    结果
    
    参考 Appendable
  - append
```
public StringBuilder append(CharSequence s,
                            int start,
                            int end)
```
    指定された〜をCharSequence序列追加到此序列。
    インデックスからstart開始のパラメータs文字は、このシーケンスの内容に順に追加され、インデックス（排他の）に達します。end 。このシーケンスの長さは、値の分だけ増加しますend - start 。
    
    设n実行するappendメソッドの前のその文字シーケンスの長さ。然后，如果k小于n ，则该字符序列中索引k处の文字は、このシーケンス内のインデックスと等しくなります。kにある文字; 否则，它等于参数s中索引k + start-n場所のs 。
    
    如果sであるnullその場合、このメソッドは、sパラメータが4つの文字を含むかのように文字を追加します。"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配列引数の部分配列の文字列表現をこのシーケンスに追加します。
    インデックスからoffset始まるchar阵列str文字は順番にこのシーケンスの内容に追加されます。このシーケンスの長さは、値だけ増加しますlen 。
    
    整体效果就像通过方法String.valueOf(char[],int,int)引数を文字列に変換します一样、およびこの文字シーケンスに対するその文字列の文字ならばappended 。
    
    参数
    
    str- 追加する文字。
    
    offset- 追加する最初のcharのインデックス。
    
    len- 追加するcharの数量。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    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 - a 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 - a float 。
    
    结果
    
    このオブジェクトへの参照。
  - append
```
public StringBuilder append(double d)
```
    将double引数の文字列表現をこのシーケンスに追加します。
    整体效果就像通过方法String.valueOf(double)引数を文字列に変換します一样、かつこの文字列の文字は、その後その文字シーケンスのappended 。
    
    参数
    
    d - a double 。
    
    结果
    
    このオブジェクトへの参照。
  - appendCodePoint
```
public StringBuilder appendCodePoint(int codePoint)
```
    将codePoint引数の文字列表現をこのシーケンスに追加します。
    この引数はこのシーケンスの内容に追加されます。そのシーケンスの長さが増加しますCharacter.charCount(codePoint) 。
    
    整体效果就像通过方法Character.toChars(int)引数を変換するchar配列と同じであり、その配列内の文字はならばappended 。
    
    参数
    
    codePoint- Unicodeコードポイント
    
    结果
    
    このオブジェクトへの参照。
    
    以下のバージョンから：
    
    1.5
  - 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 char s。部分配列の文字は、その位置におけるindex指定された位置でこのシーケンスに挿入します。そのシーケンスの長さが増加しますlen char s。
    
    参数
    
    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引数の文字列表現をこの文字シーケンスに挿入します。
    全体のな効果は、メソッドを介した第2引数とString.valueOf(Object)文字列に変換する完全相同また、この文字列の文字は、指定されたオフセットの文字シーケンス内にあります。inserted 。
    
    offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。
    
    参数
    
    offset- オフセット。
    
    obj - Object 。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    StringIndexOutOfBoundsException- オフセットが無効な場合。
  - insert
```
public StringBuilder insert(int offset,
                            String str)
```
    将字符串插入此字符序列。
    Stringパラメータの文字は、指定されたオフセットでこのシーケンスに順番に挿入され、元々その位置より上にあった文字を上に移動させ、シーケンスの長さはパラメータの長さだけ増加します。如果strであるnull ，则将四个字符"null"插入到该序列中。
    
    新字符序列中索引k位置の文字が等しい：
    
    如果k小于offset ，则旧字符序列中索引kの位置の文字
    
    参数str中のインデックスはk -offsetの文字、もしk不小于offset但小于offset+str.length()
    
    旧文字シーケンス内のインデックスはk -str.length()の文字、もしk不小于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 。
    
    此序列中索引k位置の文字は次の値と等しくなります：
    
    如果k小于dstOffset ，则该序列中索引kの位置の文字
    
    参数s中のインデックスはk +start-dstOffsetの文字、もしk大于或等于dstOffset但小于dstOffset+end-start
    
    如果k大于或等于dstOffset+end-start、このシーケンス内のインデックスはk -(end-start)の文字
    
    dstOffset参数必须大于或等于0、かつこのシーケンス以下length 。
    
    start パラメータは非負で、かつ ... 以下でなければなりません。end 。
    
    结束参数必须大于或等于start、かつsの長さ以下です。
    
    如果sであるnull、この場合、このメソッドは、sパラメータが4つの文字を含む文字列であるかのように文字を挿入します。"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引数の文字列表現をこのシーケンスに挿入します。
    全体のな効果は、メソッドを介した第2引数とString.valueOf(boolean)文字列に変換する完全相同、指定されたオフセットでその文字列の文字がこの文字シーケンスに挿入され、その後inserted 。
    
    offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。
    
    参数
    
    offset- オフセット。
    
    b - a boolean 。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    StringIndexOutOfBoundsException- オフセットが無効な場合。
  - insert
```
public StringBuilder insert(int offset,
                            char c)
```
    将char引数の文字列表現をこのシーケンスに挿入します。
    全体のな効果は、メソッドを介した場合とString.valueOf(char)第2引数を文字列に変換します完全相同、また、この文字列内の文字は指定されたオフセット位置でこの文字シーケンスに入り、その後はinserted 。
    
    offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。
    
    参数
    
    offset- オフセット。
    
    c - a 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引数の文字列表現をこのシーケンスに挿入します。
    全体の効果は、2番目の引数がメソッドによって文字列に変換された場合とまったく同じですString.valueOf(long)、そして文字列の文字はinserted指示されたオフセットにその文字シーケンスを挿入します。
    
    offset参数必须大于或等于0、かつこのシーケンス以下length 。
    
    参数
    
    offset- オフセット。
    
    l - long 。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    StringIndexOutOfBoundsException- オフセットが無効な場合。
  - insert
```
public StringBuilder insert(int offset,
                            float f)
```
    将float引数の文字列表現をこのシーケンスに挿入します。
    全体のな効果は、メソッドを介した場合とString.valueOf(float)第2引数を文字列に変換します完全相同また、この文字列の文字は、指定されたオフセットの文字シーケンス内にあります。inserted 。
    
    offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。
    
    参数
    
    offset- オフセット。
    
    f - float 。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    StringIndexOutOfBoundsException- オフセットが無効な場合。
  - insert
```
public StringBuilder insert(int offset,
                            double d)
```
    将double引数の文字列表現をこのシーケンスに挿入します。
    全体のな効果は、メソッドを介した場合とString.valueOf(double)第2引数を文字列に変換します完全相同また、この文字列の文字は、指定されたオフセットの文字シーケンス内にあります。inserted 。
    
    offset参数必须大于或等于0、かつこのシーケンス以下length 。
    
    参数
    
    offset- オフセット。
    
    d - a double 。
    
    结果
    
    このオブジェクトへの参照。
    
    异常
    
    StringIndexOutOfBoundsException- オフセットが無効な場合。
  - indexOf
```
public int indexOf(String str)
```
    指定された部分文字列が最初に出現する文字列内のインデックスを返します。
    返されるインデックスは最小値ですk ，其中：
    
    this.toString().startsWith(str, k)
    そのような値がない場合k存在するならば、-1返回。
    参数
    
    str- 検索する部分文字列。
    
    结果
    
    指定された部分文字列が最初に出現するインデックス。そのような出現がない場合は、-1 。
  - indexOf
```
public int indexOf(String str,
                   int fromIndex)
```
    指定されたインデックスから開始して、指定された部分文字列が最初に出現する文字列内のインデックスを返します。
    返されるインデックスは最小値ですk ，其中：
    
    k >= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
    そのような値がない場合k存在するならば、-1返回。
    参数
    
    str- 検索する部分文字列。
    
    fromIndex- 検索を開始するインデックス。
    
    结果
    
    指定されたインデックスから始まる、指定された部分文字列が最初に出現するインデックス。そのような出現がない場合は、-1 。
  - lastIndexOf
```
public int lastIndexOf(String str)
```
    指定された部分文字列が最後に出現する文字列内のインデックスを返します。空文字列“”の最後の出現は、インデックス値において発生するとみなされます。this.length() 。
    返されるインデックスは最大値ですk ，其中：
    
    this.toString().startsWith(str, k)
    そのような値がない場合k存在するならば、-1返回。
    参数
    
    str- 検索する部分文字列。
    
    结果
    
    指定された部分文字列が最後に出現するインデックス。そのような出現がない場合は、-1 。
  - lastIndexOf
```
public int lastIndexOf(String str,
                       int fromIndex)
```
    指定された部分文字列が最後に出現する文字列内のインデックスを、指定されたインデックスから後方に検索して返します。
    返されるインデックスは最大値ですk ，其中：
    
    k <= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
    そのような値がない場合k存在するならば、-1返回。
    参数
    
    str- 検索する部分文字列。
    
    fromIndex- 検索を開始するインデックス。
    
    结果
    
    指定された部分文字列の最後の出現のインデックス。指定されたインデックスから逆方向に検索します。そのような場合がない場合は、-1 。
  - reverse
```
public StringBuilder reverse()
```
    この文字シーケンスがシーケンスの逆順に置き換えられます。シーケンスにサロゲートペアが含まれている場合、逆方向の操作ではそれらのサロゲートペアは単一の文字として扱われます。したがって、上位サロゲートと下位サロゲートの順序が逆転することはありません。设n実行するreverseメソッドの前のこの文字シーケンスの文字長（ではなくchar値の長さ）。然后，新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。nk-1にある文字。
    逆の操作では、操作前はペアになっていない低サロゲートと高サロゲートからなるサロゲートペアが生成される可能性があることに注意してください。例えば、“\ uDC00 \ uD800”を反転すると“\ uD800 \ uDC00”が生成され、これは有効なサロゲートペアです。
    
    结果
    
    このオブジェクトへの参照。
  - length
```
public int length()
```
    返回长度（字符数）。
    
    Specified by:
    
    lengthインターフェースでCharSequence
    
    结果
    
    このオブジェクトによって現在表される文字シーケンスの長さ
  - capacity
```
public int capacity()
```
    返回当前容量。容量は、新しく挿入された文字が使用できるストレージ量であり、この容量を超えると割り当てが行われます。
    
    结果
    
    現在の容量
  - ensureCapacity
```
public void ensureCapacity(int minimumCapacity)
```
    容量が指定された最小値以上であることを保証します。現在の容量が引数より小さい場合、より大きな容量を持つ新しい内部配列が割り当てられます。新しい容量はより大きい：
    
    minimumCapacity参数。
    
    旧容量の2倍に、加えて2 。
    
    如果minimumCapacityパラメータが非正数の場合、このメソッドは何も実行せず、単に返します。このオブジェクトに対する後続の操作により、実際の容量がここで要求された容量よりも低くなる可能性があることに注意してください。
    参数
    
    minimumCapacity必要な最小容量。
  - trimToSize
```
public void trimToSize()
```
    文字シーケンス用の記憶容量を削減しようとします。バッファが現在の文字シーケンスを保持するために必要なサイズより大きい場合、スペース効率を高めるためにサイズを調整できます。このメソッドを呼び出すと、後続の呼び出しに影響をとえる可能性があります（ただし必須ではありません）。capacity()メソッドが返す値。
  - setLength
```
public void setLength(int newLength)
```
    文字シーケンスの長さを設定します。このシーケンスは、引数で指定された長さの新しい文字シーケンスに変更されます。非負の各インデックス未満の場合k newLength、新しい文字シーケンスのインデックスでkその位置の文字は、古いシーケンスのインデックスの文字と同じです。k如果k元の文字シーケンスの長さより短い文字; そうでなければ、それはヌル文字です。'\u0000' 。换句话说，如果newLengthパラメータが現在の長さ未満の場合、長さは指定された長さに変更されます。
    如果newLengthパラメータが現在の長さ以上の場合は、十分な数のヌル文字が追加されます（'\u0000'）、lengthが...となるようにnewLength参数。
    
    newLength参数必须大于或等于0 。
    
    参数
    
    newLength - 新长度
    
    异常
    
    IndexOutOfBoundsException - 如果 newLengthパラメータが負の場合。
  - charAt
```
public char charAt(int index)
```
    指定されたインデックスにある、このシーケンス内の...を返します。char值。第一个char值位于索引0 ，下一个位于索引1 ，依此类推，如数组索引中所示。
    index参数必须大于或等于0、かつこのシーケンスの長さ未満。
    
    指定されたインデックスの場合char値はsurrogate ，则返回代理值。
    
    Specified by:
    
    charAtインターフェースでCharSequence
    
    参数
    
    index - 所需 char値のインデックス。
    
    结果
    
    指定されたインデックスのchar值。
    
    异常
    
    IndexOutOfBoundsException - 如果 index負の場合、または...以上length() 。
  - codePointAt
```
public int codePointAt(int index)
```
    指定されたインデックスの文字（Unicodeコードポイント）を返します。索引引用char値（Unicodeコード単位）、範囲は0到CharSequence.length() - 1 。
    もし与えられたインデックスにある指定されたchar値が上位サロゲート範囲にある場合、次のインデックスはこのシーケンスの長さ未満であり、次のインデックスの文字はchar値が低サロゲート範囲にある場合、そのサロゲートペアに対応する補助コードポイントが返されます。そうでなければ、与えられたインデックスのchar值。
    
    参数
    
    index - char値のインデックス
    
    结果
    
    index位置の文字のコードポイント値
    
    异常
    
    IndexOutOfBoundsException - 如果 indexパラメータが負であるか、このシーケンスの長さ以上である。
  - codePointBefore
```
public int codePointBefore(int index)
```
    指定されたインデックスの前の文字（Unicodeコードポイント）を返します。索引引用char値（Unicodeコード単位）、範囲は1到CharSequence.length() 。
    如果char値で(index - 1)处于低代理项范围， (index - 2)負ではなく、かつchar値で(index - 2)高サロゲート範囲にある場合、サロゲートペアの補助コードポイント値を返します。如果char値でindex - 1ペアにならない低サロゲートまたは高サロゲートである場合、そのサロゲート値を返します。
    
    参数
    
    index返されるべきコードポイントの後のインデックス
    
    结果
    
    指定されたインデックスの前のUnicodeコードポイント値。
    
    异常
    
    IndexOutOfBoundsException - 如果 indexパラメータが1より小さいか、このシーケンスの長さより大きい。
  - codePointCount
```
public int codePointCount(int beginIndex,
                          int endIndex)
```
    このシーケンスの指定されたテキスト範囲内のUnicodeコードポイント数を返します。テキスト範囲は、指定されたbeginIndex ，并延伸到charインデックスでendIndex - 1 。したがって、テキスト範囲の長さ（においてchars中）はendIndex-beginIndex 。このシーケンス内のペアになっていないサロゲートは、各コードポイントとして数えられます。
    
    参数
    
    beginIndexテキスト範囲の最初のcharのインデックス。
    
    endIndex- テキスト範囲の最後charの後のインデックス。
    
    结果
    
    指定されたテキスト範囲内のUnicodeコードポイント数
    
    异常
    
    IndexOutOfBoundsException - 如果 beginIndex負の場合、またはendIndexこのシーケンスの長さより大きい、またはbeginIndex大于 endIndex 。
  - offsetByCodePoints
```
public int offsetByCodePoints(int index,
                              int codePointOffset)
```
    指定された位置からこのシーケンス内のインデックスを返します。index偏移codePointOffset代码点。 indexとcodePointOffset指定されたテキスト範囲内のペアになっていないサロゲートは、各コードポイントとして数えられます。
    
    参数
    
    index- オフセットするインデックス
    
    codePointOffsetコードポイント内のオフセット
    
    结果
    
    このシーケンス内のインデックス
    
    异常
    
    IndexOutOfBoundsException - 如果 index負であるか、このシーケンスの長さより大きい場合、またはcodePointOffsetが正でかつ〜からindex始まる部分文字列index具有少于 codePointOffsetコードポイント、またはもしcodePointOffset負であり、index前の部分文字列index絶対値より小さいcodePointOffset代码点。
  - getChars
```
public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)
```
    文字をこのシーケンスからターゲット文字配列にコピーします。dst 。コピーされる最初の文字はインデックスsrcBegin ; コピーされる最後の文字はインデックスにあります。srcEnd-1 。コピーする文字の総数はsrcEnd-srcBegin 。文字がコピーされるdstの子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 。このシーケンスは、古い文字シーケンスと同じ新しい文字シーケンスを表すように変更されます。ただし、それが含む文字は...に位置します。chの文字index 。
    index参数必须大于或等于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 。
  - chars
```
public IntStream chars()
```
    返回intのストリームは、このシーケンス内のchar值进行零扩展。任何映射到サロゲートコードポイントの文字はすべて未解釈です。
    終端ストリーム操作が開始されると、ストリームはそのシーケンスにバインドされます（具体的には、可変シーケンスの場合、ストリームの分裂器であるlate-binding ）。その操作の間にシーケンスが変更された場合は、結果は未定義です。
    
    Specified by:
    
    charsインターフェースでCharSequence
    
    结果
    
    このシーケンスからのchar値のIntStream
    
    以下のバージョンから：
    
    9
  - codePoints
```
public IntStream codePoints()
```
    このシーケンス内のコードポイント値のストリームを返します。シーケンス内で遭遇した任意のサロゲートペアは、あたかも結合されCharacter.toCodePoint一样，结果传递给流。その他のコードユニット（通常のBMP文字、対になっていないサロゲート、未定義のコードユニットを含む）はゼロ拡張されます。int值，然后传递给流。
    終端ストリーム操作が開始されると、ストリームはそのシーケンスにバインドされます（具体的には、可変シーケンスの場合、ストリームの分裂器であるlate-binding ）。その操作の間にシーケンスが変更された場合は、結果は未定義です。
    
    Specified by:
    
    codePointsインターフェースでCharSequence
    
    结果
    
    UnicodeコードのIntStreamはこのシーケンスを指す
    
    以下のバージョンから：
    
    9

Class StringBuilder

コンストラクタの概要

メソッドの概要

メソッドを宣言しているクラス java.lang.Object

メソッドを宣言しているインタフェース java.lang.CharSequence

コンストラクタの詳細

StringBuilder

StringBuilder

StringBuilder

StringBuilder

メソッドの詳細

compareTo

append

append

append

append

append

append

append

append

append

append

append

append

append

appendCodePoint

delete

deleteCharAt

replace

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

indexOf

indexOf

lastIndexOf

lastIndexOf

reverse

length

capacity

ensureCapacity

trimToSize

setLength

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

setCharAt

substring

subSequence

substring

chars

codePoints