模块  java.base
软件包  java.lang

Class StringBuffer

  • 実装されているすべてのインターフェース
    Serializable , Appendable , CharSequence , Comparable<StringBuffer>

    public final class StringBuffer
    extends Object
    implements Serializable, Comparable<StringBuffer>, CharSequence
    スレッドセーフな可変文字シーケンス。 字符串缓冲区类似于String ,但可以进行修改。 任意の時点で、それは特定の文字シーケンスを含みますが、シーケンスの長さと内容は、いくつかのメソッド呼び出しによって変更できます。

    字符串缓冲区可供多个线程使用。 これらのメソッドは必要に応じて同期化され、任意の特定のインスタンスに対するすべての操作が、関とする各スレッドが行うメソッド呼び出しの順序と一貫した何らかの直列順序で行われるかのように動作することを保証します。

    StringBuffer上の主要な操作はappendとinsertメソッド。これらは任意の型のデータを受け入れるようにオーバーロードされています。 それぞれが、指定されたデータを実質のに文字列に変換し、その文字列の文字を文字列バッファに追加または挿入します。 appendメソッドは常にこれらの文字をバッファの末尾に追加します; insert指定された位置に文字を追加するメソッド。

    例如,如果zその現在の内容を参照して"start"の文字列バッファオブジェクトの場合、メソッド呼び出しはz.append("le")将导致字符串缓冲区包含"startle" ,而z.insert(4, "le")将更改字符串缓冲区以包含"starlet" 。

    一般のに、何らかのインスタンスを指す場合はStringBuffer ,然后sb.append(x)同じ効果を持つsb.insert(sb.length(), x) 。

    ソースシーケンスに対する操作が行われるとき(ソースシーケンスからの追加や挿入など)、このクラスは操作を実行する文字列バッファ上でのみ同期され、ソース上では同期されません。 请注意,虽然StringBuffer複数のスレッドから同時に安全に使用できるように設計されていますが、コンストラクタまたはappend或insert操作がスレッド間で共有されるソースシーケンスを渡される場合、呼び出しコードは、操作の期間中、操作がソースシーケンスの一貫した不変のビューを持つことを保証する必要があります。 これは、操作呼び出し中にロックを保持する呼び出し元によって、不変のソースシーケンスを使用することによって、またはソースシーケンスをスレッド間で共有しないことによって満たすことができます。

    每个字符串缓冲区都有容量。 文字列バッファに含まれる文字シーケンスの長さが容量を超えない限り、新しい内部バッファ配列を割り当てる必要はありません。 如果内部缓冲区溢出,它会自动变大。

    除非另有说明,否则将null参数传递给null中のコンストラクタまたはメソッドは、例外のスローを引き起こします。NullPointerException 。

    JDK 5 バージョン以降、このクラスには、単一スレッド用に設計された同等のクラスが追加され、StringBuilder 。 通常应优先使用StringBuilderクラス。これは、同じ操作をすべてサポートしますが、同期を実行しないため高速です。

    API Note:
    StringBuffer实现Comparable但不覆盖equals 。 因此, StringBuffer自然順序はequalsと一致しません。 如果StringBufferオブジェクトとして使用StringBufferのキーまたはSortedMap元素, SortedSet 。 见Comparable , SortedMap ,或SortedSet获取更多信息。
    以下のバージョンから:
    1.0
    另请参见:
    StringBuilder , String , Serialized Form
    • コンストラクタの概要

      构造方法  
      构造器 描述
      StringBuffer()
      文字を含まない文字列バッファを構築し、初期容量は16文字です。
      StringBuffer​(int capacity)
      文字を含まず、指定された初期容量を持つ文字列バッファを構築します。
      StringBuffer​(CharSequence seq)
      指定された...を含む文字列バッファを構築します。CharSequence同じ文字。
      StringBuffer​(String str)
      指定された文字列の内容に初期化された文字列バッファを構築します。
    • メソッドの概要

      所有方法  インスタンスメソッド 具体的な方法 
      変数と型 方法 描述
      StringBuffer append​(boolean b)
      将 boolean引数の文字列表現をシーケンスに追加します。
      StringBuffer append​(char c)
      将 char引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(char[] str)
      将 char配列引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(char[] str, int offset, int len)
      将 char配列引数の部分配列の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(double d)
      将 double引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(float f)
      将 float引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(int i)
      将 int引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(long lng)
      将 long引数の文字列表現をこのシーケンスに追加します。
      StringBuffer append​(CharSequence s)
      指定された〜をCharSequence追加到此序列。
      StringBuffer append​(CharSequence s, int start, int end)
      指定された〜をCharSequence序列附加到此序列。
      StringBuffer append​(Object obj)
      追加 Object引数の文字列表現。
      StringBuffer append​(String str)
      指定された文字列をこの文字シーケンスに追加します。
      StringBuffer append​(StringBuffer sb)
      指定された〜をStringBuffer追加到此序列。
      StringBuffer 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​(StringBuffer another)
      StringBuffer字典顺序比较两个 StringBuffer实例。
      StringBuffer delete​(int start, int end)
      このシーケンスの部分文字列内の文字を削除します。
      StringBuffer 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)
      指定されたインデックスから開始して、指定された部分文字列が最初に出現する文字列内のインデックスを返します。
      StringBuffer insert​(int offset, boolean b)
      将 boolean引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, char c)
      将 char引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, char[] str)
      将 char配列引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int index, char[] str, int offset, int len)
      将 str配列引数の部分配列の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, double d)
      将 double引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, float f)
      将 float引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, int i)
      将第二个 intパラメータの文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int offset, long l)
      将 long引数の文字列表現をこのシーケンスに挿入します。
      StringBuffer insert​(int dstOffset, CharSequence s)
      指定された〜をCharSequence插入此序列。
      StringBuffer insert​(int dstOffset, CharSequence s, int start, int end)
      指定された〜をCharSequence序列插入此序列。
      StringBuffer insert​(int offset, Object obj)
      将 Objectパラメータの文字列表現をこの文字シーケンスに挿入します。
      StringBuffer insert​(int offset, String str)
      将字符串插入此字符序列。
      int lastIndexOf​(String str)
      指定された部分文字列が最後に出現する文字列内のインデックスを返します。
      int lastIndexOf​(String str, int fromIndex)
      指定された部分文字列が最後に出現する文字列内のインデックスを、指定されたインデックスから後方に検索して返します。
      int offsetByCodePoints​(int index, int codePointOffset)
      指定された位置からこのシーケンス内のインデックスを返します。index偏移 codePointOffset代码点。
      StringBuffer replace​(int start, int end, String str)
      指定されたものを使ってStringの文字をこのシーケンスの部分文字列内の文字に置き換えます。
      StringBuffer 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()
      文字シーケンス用の記憶容量を削減しようとします。
    • コンストラクタの詳細

      • StringBuffer

        public StringBuffer()
        文字を含まない文字列バッファを構築し、初期容量は16文字です。
      • StringBuffer

        public StringBuffer​(int capacity)
        文字を含まず、指定された初期容量を持つ文字列バッファを構築します。
        参数
        capacity- 初期容量。
        异常
        NegativeArraySizeException - 如果 capacity参数小于 0 。
      • StringBuffer

        public StringBuffer​(String str)
        指定された文字列の内容に初期化された文字列バッファを構築します。 文字列バッファーの初期容量は16文字列引数の長さを加える。
        参数
        str- バッファの初期内容。
      • StringBuffer

        public StringBuffer​(CharSequence seq)
        指定された...を含む文字列バッファを構築します。CharSequence同じ文字。 文字列バッファーの初期容量は16加上CharSequence引数の長さ。

        指定された場合、CharSequenceの長さが0以下の場合は、容量を返します。16の空のバッファ。

        参数
        seq- コピーするシーケンス。
        以下のバージョンから:
        1.5
    • メソッドの詳細

      • compareTo

        public int compareTo​(StringBuffer another)
        StringBuffer字典顺序比较两个StringBuffer实例。 该方法遵循CharSequence.compare(this, another)メソッド内で定義されている辞書式比較と同じ規則。

        細かい粒度で、ロケール依存のString比較については、参照してください。Collator 。

        Specified by:
        compareTo ,界面 Comparable<StringBuffer>
        Implementation Note:
        このメソッドはthis(現在のオブジェクト)上で同期するが、~とはしないthis StringBuffer同期を実行し、StringBuffer anotherとthis StringBuffer进行比较。
        参数
        another - StringBuffer比較のStringBuffer
        结果
        值0如果此StringBufferパラメータとを含むStringBuffer同じ文字シーケンス; 如果此StringBuffer辞書順で小さいStringBuffer参数, StringBuffer负整数; 如果此StringBuffer辞書順で大きいStringBuffer参数, StringBuffer正整数。
        以下のバージョンから:
        11
      • capacity

        public int capacity()
        返回当前容量。 容量は、新しく挿入された文字が使用できるストレージ量であり、この容量を超えると割り当てが行われます。
        结果
        現在の容量
      • ensureCapacity

        public void ensureCapacity​(int minimumCapacity)
        容量が指定された最小値以上であることを保証します。 現在の容量が引数より小さい場合、より大きな容量を持つ新しい内部配列が割り当てられます。 新しい容量はより大きい:
        • minimumCapacity论点。
        • 以前の容量の2倍に、さらに2 。
        如果minimumCapacityパラメータが非正数の場合、このメソッドは何も実行せず、単に返します。 このオブジェクトに対する後続の操作により、実際の容量がここで要求された容量よりも低くなる可能性があることに注意してください。
        参数
        minimumCapacity- 必要な最小容量。
      • trimToSize

        public void trimToSize()
        文字シーケンス用の記憶容量を削減しようとします。 バッファが現在の文字シーケンスを保持するために必要なサイズより大きい場合、スペース効率を高めるためにサイズを調整できます。 このメソッドを呼び出すと、後続の呼び出しに影響をとえる可能性があります(ただし必須ではありません)。capacity()メソッドが返す値。
        以下のバージョンから:
        1.5
      • setLength

        public void setLength​(int newLength)
        文字シーケンスの長さを設定します。 このシーケンスは、引数で指定された長さの新しい文字シーケンスに変更されます。 非負の各インデックス未満の場合k newLength、新しい文字シーケンスのインデックスでkその位置の文字は、古いシーケンスのインデックスの文字と同じです。k如果k元の文字シーケンスの長さより短い文字; そうでなければ、それはヌル文字です。'\u0000' 。 换句话说,如果newLengthパラメータが現在の長さ未満の場合、長さは指定された長さに変更されます。

        如果newLengthパラメータが現在の長さ以上の場合は、十分な数のヌル文字が追加されます('\u0000')、lengthが...となるようにnewLength参数。

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

        参数
        newLength - 新长度
        异常
        IndexOutOfBoundsException - 如果 newLength引数が負の場合。
        另请参见:
        CharSequence.length()
      • charAt

        public char charAt​(int index)
        指定されたインデックスにある、このシーケンス内の...を返します。char值。 第一个char值位于索引0 ,下一个位于索引1 ,依此类推,如数组索引中所示。

        index参数必须大于或等于0、かつこのシーケンスの長さ未満。

        指定されたインデックスの場合char値はsurrogate ,则返回代理值。

        Specified by:
        charAtインターフェースでCharSequence
        参数
        index - 所需 char値のインデックス。
        结果
        指定されたインデックスのchar值。
        异常
        IndexOutOfBoundsException - 如果 index負の場合、または以上length() 。
        另请参见:
        CharSequence.length()
      • codePointAt

        public int codePointAt​(int index)
        指定されたインデックスの文字(Unicodeコードポイント)を返します。 索引引用char値(Unicodeコード単位)、範囲は0到CharSequence.length() - 1 。

        もし与えられたインデックスにある指定されたchar値が上位サロゲート範囲にある場合、次のインデックスはこのシーケンスの長さ未満であり、次のインデックスの文字はchar値が低サロゲート範囲にある場合、そのサロゲートペアに対応する補助コードポイントが返されます。 そうでなければ、与えられたインデックスのchar值。

        参数
        index - char値のインデックス
        结果
        indexの文字のコードポイント値
        异常
        IndexOutOfBoundsException - 如果 indexパラメータが負数であるか、このシーケンスの長さ以上である。
        以下のバージョンから:
        1.5
      • 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未満であるか、このシーケンスの長さより大きい。
        以下のバージョンから:
        1.5
      • 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 。
        以下のバージョンから:
        1.5
      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                                      int codePointOffset)
        指定された位置からこのシーケンス内のインデックスを返します。index偏移codePointOffset代码点。 indexとcodePointOffset指定されたテキスト範囲内のペアになっていないサロゲートは、各コードポイントとして数えられます。
        参数
        index- オフセットするインデックス
        codePointOffset- コードポイント単位のオフセット
        结果
        このシーケンス内のインデックス
        异常
        IndexOutOfBoundsException - 如果 index負であるか、このシーケンスの長さより大きい場合、またはcodePointOffsetが正でかつ〜からindex始まる部分文字列codePointOffset代码点少于 codePointOffset ,或者 codePointOffset負であり、index前の部分文字列index絶対値未満の絶対値codePointOffset代码点。
        以下のバージョンから:
        1.5
      • 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 。 このシーケンスは、元の文字シーケンスと同じで、その文字を含む点だけが異なる新しい文字シーケンスを表すように変更されます。ch位置でindex 。

        index参数必须大于或等于0、かつこのシーケンスの長さ未満。

        参数
        index- 変更する文字のインデックス。
        ch- 新しい文字。
        异常
        IndexOutOfBoundsException - 如果 index負の場合、または以上length() 。
        另请参见:
        CharSequence.length()
      • append

        public StringBuffer append​(Object obj)
        追加Object引数の文字列表現。

        全体のな効果は、メソッドを介した場合とString.valueOf(Object)引数を文字列に変換します完全相同、そしてその文字列の文字はその後...ですappended到此字符序列。

        参数
        obj - Object 。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(String str)
        指定された文字列をこの文字シーケンスに追加します。

        Stringパラメータの文字は順に追加され、このシーケンスの長さはパラメータの長さだけ増加します。 如果strであるnull ,则附加四个字符"null" 。

        设n実行するappendメソッドの前のその文字シーケンスの長さ。 如果k小于n ,则新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。kにある文字; 否则,它等于参数str中索引knにある文字。

        参数
        str- 文字列。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(StringBuffer sb)
        指定された〜をStringBuffer追加到此序列。

        前記の文字StringBuffer引数を追加するために、その内容StringBuffer、この長さを増加させるStringBuffer引数の長さだけ。 如果sbであるnull ,则四个字符"null"将附加到此StringBuffer 。

        令n古い文字シーケンスの長さ、つまり実行時にappend方法之前StringBuffer含まれる文字シーケンスの長さ。 如果k小于n ,则新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。kにある文字; 否则,它等于参数sb中索引knにある文字。

        このメソッドはターゲットオブジェクトにおいてthis同期するが、ソース上では同期しない(sb )。

        参数
        sb- 追加するStringBuffer 。
        结果
        このオブジェクトへの参照。
        以下のバージョンから:
        1.4
      • append

        public StringBuffer append​(CharSequence s)
        指定された〜をCharSequence追加到此序列。

        CharSequenceパラメータの文字は順に追加され、このシーケンスの長さはパラメータの長さだけ増加します。

        このメソッドの結果は、this.append(s, 0, s.length()) を呼び出した場合と完全に同じです。

        このメソッドはターゲットオブジェクトにおいてthis同期するが、ソース上では同期しない(s )。

        如果sであるnull ,则附加四个字符"null" 。

        Specified by:
        append接口 Appendable
        参数
        s- 追加するCharSequence 。
        结果
        このオブジェクトへの参照。
        以下のバージョンから:
        1.5
      • append

        public StringBuffer 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()
        以下のバージョンから:
        1.5
      • append

        public StringBuffer append​(char[] str)
        将char配列引数の文字列表現をこのシーケンスに追加します。

        配列引数の文字は、このシーケンスの内容に順番に追加されます。 このシーケンスの長さは、引数の長さだけ増加します。

        整体效果就像通过方法String.valueOf(char[])引数を文字列に変換します一样、そしてその文字列の文字はその後...ですappended到此字符序列。

        参数
        str- 追加する文字。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(char[] str,
                                   int offset,
                                   int len)
        将char配列引数の部分配列の文字列表現をこのシーケンスに追加します。

        インデックスからoffset始まるchar阵列str文字は順番にこのシーケンスの内容に追加されます。 このシーケンスの長さは、値だけ増加しますlen 。

        整体效果就像通过方法String.valueOf(char[],int,int)引数を文字列に変換します一样、そしてその文字列の文字はその後...ですappended到此字符序列。

        参数
        str- 追加する文字。
        offset- 追加する最初のcharのインデックス。
        len- 追加するcharsの数。
        结果
        このオブジェクトへの参照。
        异常
        IndexOutOfBoundsException- の場合はoffset < 0或 len < 0或 offset+len > str.length
      • append

        public StringBuffer append​(boolean b)
        将boolean引数の文字列表現をシーケンスに追加します。

        全体のな効果は、メソッドを介した場合とString.valueOf(boolean)引数を文字列に変換します完全相同、そしてその文字列の文字はその後...ですappended到此字符序列。

        参数
        b - a boolean 。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(char c)
        将char引数の文字列表現をこのシーケンスに追加します。

        この引数はこのシーケンスの内容に追加されます。 このシーケンスの長さが増加する1 。

        全体の効果はメソッドとString.valueOf(char)引数を文字列に変換します完全相同、そしてその文字列内の文字はappended 。

        Specified by:
        appendインターフェースでAppendable
        参数
        c - a char 。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(int i)
        将int引数の文字列表現をこのシーケンスに追加します。

        整体效果就像通过方法String.valueOf(int)引数を文字列に変換します一样、そしてその文字列の文字はその後...ですappended到此字符序列。

        参数
        i - int 。
        结果
        このオブジェクトへの参照。
      • appendCodePoint

        public StringBuffer appendCodePoint​(int codePoint)
        将codePoint引数の文字列表現をこのシーケンスに追加します。

        この引数はこのシーケンスの内容に追加されます。 そのシーケンスの長さが増加しますCharacter.charCount(codePoint) 。

        全体のな効果は、メソッドを介した場合とCharacter.toChars(int)引数を変換するchar数组完全相同,そして、その配列内の文字は続いてappended到此字符序列。

        参数
        codePoint- Unicodeコードポイント
        结果
        このオブジェクトへの参照。
        以下のバージョンから:
        1.5
      • append

        public StringBuffer append​(long lng)
        将long引数の文字列表現をこのシーケンスに追加します。

        全体のな効果は、メソッドを介した場合とString.valueOf(long)引数を文字列に変換します完全相同、その後、その文字列の文字がこの文字シーケンスのappended 。

        参数
        lng - a long 。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(float f)
        将float引数の文字列表現をこのシーケンスに追加します。

        全体のな効果は、メソッドを介した場合とString.valueOf(float)引数を文字列に変換します完全相同、その後、その文字列の文字がこの文字シーケンスのappended 。

        参数
        f - a float 。
        结果
        このオブジェクトへの参照。
      • append

        public StringBuffer append​(double d)
        将double引数の文字列表現をこのシーケンスに追加します。

        全体の効果はメソッドとString.valueOf(double)引数を文字列に変換します完全相同、その後、この文字列の文字はappended 。

        参数
        d - a double 。
        结果
        このオブジェクトへの参照。
      • delete

        public StringBuffer delete​(int start,
                                   int end)
        このシーケンスの部分文字列内の文字を削除します。 指定されたインデックスからの部分文字列start開始し、そのような文字が存在しない場合、インデックスまで拡張されます。end - 1の位置の文字、またはシーケンスの末尾。 如果start等于end ,则不进行任何更改。
        参数
        start- 開始インデックス(含む)。
        end- 終了インデックス(含まない)。
        结果
        このオブジェクト。
        异常
        StringIndexOutOfBoundsException - 如果 start負の場合、またはより大きいlength() ,或大于 end 。
        以下のバージョンから:
        1.2
      • deleteCharAt

        public StringBuffer deleteCharAt​(int index)
        この順序で指定された位置の文字を削除するchar 。 此序列由一个char缩短。

        注意:指定されたインデックスにある文字が補助文字の場合、このメソッドは文字全体を削除しません。 補助文字の正確な処理が必要な場合は、その数を決定します。char通过调用删除Character.charCount(thisSequence.codePointAt(index)) ,其中thisSequenceこのシーケンスに対して。

        参数
        index- 削除するインデックス番号char
        结果
        このオブジェクト。
        异常
        StringIndexOutOfBoundsException - 如果 index負の場合、または以上length() 。
        以下のバージョンから:
        1.2
      • replace

        public StringBuffer replace​(int start,
                                    int end,
                                    String str)
        指定されたものを使ってStringの文字をこのシーケンスの部分文字列内の文字に置き換えます。 指定されたインデックスからの部分文字列start開始し、そのような文字が存在しない場合は、インデックスまで拡張されます。end - 1の位置の文字、またはシーケンスの末尾。 最初に部分文字列内の文字を削除し、その後String指定されたものを挿入するstart 。 (必要に応じて、指定された文字列を収容するためにこのシーケンスが拡張されます。)
        参数
        start- 開始インデックス(含む)。
        end- 終了インデックス(含まない)。
        str- 以前の内容を置き換える文字列。
        结果
        このオブジェクト。
        异常
        StringIndexOutOfBoundsException - 如果 start負の場合、またはより大きいlength() ,或大于 end 。
        以下のバージョンから:
        1.2
      • substring

        public String substring​(int start)
        新しい...を返すString、この文字シーケンスに現在含まれている文字の部分シーケンスを含むもの。 部分文字列は、指定されたインデックスから始まり、このシーケンスの末尾まで続きます。
        参数
        start- 開始インデックス(含む)。
        结果
        新しい文字列。
        异常
        StringIndexOutOfBoundsException - 如果 startゼロ未満、またはこのオブジェクトの長さより大きい。
        以下のバージョンから:
        1.2
      • subSequence

        public CharSequence subSequence​(int start,
                                        int end)
        このシーケンスの部分シーケンスである新しい文字シーケンスを返します。

        このメソッドを呼び出す形式

           sb.subSequence(begin,&nbsp;end) 
        動作は呼び出しと完全に同じです
           sb.substring(begin,&nbsp;end) 
        このメソッドは、このクラスが実装できるようにするために提供されていますCharSequence接口。
        Specified by:
        subSequence ,界面 CharSequence
        参数
        start- 開始インデックス(含む)。
        end- 終了インデックス(含まない)。
        结果
        指定された部分シーケンス。
        异常
        IndexOutOfBoundsException - 如果 start或 end負の場合、もしend大于 length() ,或者 start大于 end
        以下のバージョンから:
        1.4
      • substring

        public String substring​(int start,
                                int end)
        新しい...を返すString、このシーケンスに現在含まれている文字の部分シーケンスを含みます。 指定されたインデックスからの部分文字列start开始,并扩展到索引end - 1にある文字。
        参数
        start- 開始インデックス(含む)。
        end- 終了インデックス(含まない)。
        结果
        新しい文字列。
        异常
        StringIndexOutOfBoundsException - 如果 start或 end負の場合、またはより大きいlength() ,或 start大于 end 。
        以下のバージョンから:
        1.2
      • insert

        public StringBuffer insert​(int index,
                                   char[] str,
                                   int offset,
                                   int len)
        将str配列パラメータの部分配列の文字列表現が、このシーケンスに挿入されます。 その部分配列は指定されたoffset开始,并扩展到len char s。 部分配列の文字は、その位置におけるindex指示された位置にそのシーケンスを挿入します。 そのシーケンスの長さが増加しますlen char s。
        参数
        index- サブ配列を挿入する位置。
        str - A char阵列。
        offset- 挿入するサブ配列内の最初のcharのインデックス。
        len- 挿入するサブ配列内のcharsの数。
        结果
        このオブジェクト
        异常
        StringIndexOutOfBoundsException - 如果 index負の場合、またはより大きいlength() ,或 offset或 len負の数、または(offset+len)大于 str.length 。
        以下のバージョンから:
        1.2
      • insert

        public StringBuffer insert​(int offset,
                                   Object obj)
        将Object引数の文字列表現をこの文字シーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(Object)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。

        参数
        offset- オフセット。
        obj - Object 。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer 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 StringBuffer insert​(int offset,
                                   char[] str)
        将char配列引数の文字列表現をこのシーケンスに挿入します。

        配列引数の文字はoffset指定された位置でこのシーケンスの内容に挿入します。 このシーケンスの長さは、引数の長さだけ増加します。

        全体のな効果は、メソッドを介した場合とString.valueOf(char[])第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンスの長さ以下であるlength 。

        参数
        offset- オフセット。
        str- 文字配列。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer insert​(int dstOffset,
                                   CharSequence s)
        指定された〜をCharSequence插入此序列。

        CharSequenceパラメータの文字は、このシーケンスの指定されたオフセット位置に順番に挿入され、元々その位置より上にあった文字は上に移動し、このシーケンスの長さはパラメータsの長さだけ増加します。

        このメソッドの結果は、このオブジェクトの...を呼び出すこととinsert (dstOffset,s,0,s.length())方法完全相同 。

        如果sであるnull ,则将四个字符"null"插入到该序列中。

        参数
        dstOffset- オフセット。
        s- 挿入するシーケンス
        结果
        このオブジェクトへの参照。
        异常
        IndexOutOfBoundsException- オフセットが無効な場合。
        以下のバージョンから:
        1.5
      • insert

        public StringBuffer 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()
        以下のバージョンから:
        1.5
      • insert

        public StringBuffer insert​(int offset,
                                   boolean b)
        将boolean引数の文字列表現をこのシーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(boolean)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンス以下length 。

        参数
        offset- オフセット。
        b - a boolean 。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer insert​(int offset,
                                   char c)
        将char引数の文字列表現をこのシーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(char)第2引数を文字列に変換します完全相同、その後、この文字列内の文字は指定されたオフセットでこの文字シーケンスに挿入されます。inserted 。

        offset参数必须大于或等于0、かつこのシーケンス以下length 。

        参数
        offset - 抵消。
        c - a char 。
        结果
        このオブジェクトへの参照。
        异常
        IndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer insert​(int offset,
                                   int i)
        将第二个int引数の文字列表現をこのシーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(int)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンス以下length 。

        参数
        offset- オフセット。
        i - int 。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer insert​(int offset,
                                   long l)
        将long引数の文字列表現をこのシーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(long)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンス以下length 。

        参数
        offset - 抵消。
        l - a long 。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer insert​(int offset,
                                   float f)
        将float引数の文字列表現をこのシーケンスに挿入します。

        全体のな効果は、メソッドを介した場合とString.valueOf(float)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted 。

        offset参数必须大于或等于0、かつこのシーケンス以下length 。

        参数
        offset- オフセット。
        f - a float 。
        结果
        このオブジェクトへの参照。
        异常
        StringIndexOutOfBoundsException- オフセットが無効な場合。
      • insert

        public StringBuffer 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 。
        以下のバージョンから:
        1.4
      • 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 。
        以下のバージョンから:
        1.4
      • lastIndexOf

        public int lastIndexOf​(String str)
        指定された部分文字列が最後に出現する文字列内のインデックスを返します。 最後に出現する空文字列“”は、インデックス値で発生すると見なされます。this.length() 。

        返されるインデックスは最大値ですk ,其中:

           this.toString().startsWith(str, k)  
        そのような値がない場合k存在するならば、-1返回。
        参数
        str- 検索する部分文字列。
        结果
        指定されたサブストリングが最後に出現するインデックス。そのような場合がない場合は、-1 。
        以下のバージョンから:
        1.4
      • 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搜索。
        以下のバージョンから:
        1.4
      • reverse

        public StringBuffer reverse()
        この文字シーケンスがシーケンスの逆順に置き換えられます。 シーケンスにサロゲートペアが含まれている場合、逆方向の操作ではそれらのサロゲートペアは単一の文字として扱われます。 したがって、上位サロゲートと下位サロゲートの順序が逆転することはありません。 设n実行するreverseメソッドの前のこの文字シーケンスの文字長(ではなくchar値の長さ)。 然后,新字符序列中索引k位置にある文字は、古い文字シーケンス内のインデックス位置の文字と等しい。nk-1にある文字。

        逆の操作では、操作前はペアになっていない低サロゲートと高サロゲートからなるサロゲートペアが生成される可能性があることに注意してください。 例えば、“\ uDC00 \ uD800”を反転すると“\ uD800 \ uDC00”が生成され、これは有効なサロゲートペアです。

        结果
        このオブジェクトへの参照。
        以下のバージョンから:
        1.0.2
      • 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