- java.lang.Object
-
- java.lang.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)指定された文字列の内容に初期化された文字列バッファを構築します。
-
メソッドの概要
所有方法 インスタンスメソッド 具体的な方法 変数と型 方法 描述 StringBufferappend(boolean b)将boolean引数の文字列表現をシーケンスに追加します。StringBufferappend(char c)将char引数の文字列表現をこのシーケンスに追加します。StringBufferappend(char[] str)将char配列引数の文字列表現をこのシーケンスに追加します。StringBufferappend(char[] str, int offset, int len)将char配列引数の部分配列の文字列表現をこのシーケンスに追加します。StringBufferappend(double d)将double引数の文字列表現をこのシーケンスに追加します。StringBufferappend(float f)将float引数の文字列表現をこのシーケンスに追加します。StringBufferappend(int i)将int引数の文字列表現をこのシーケンスに追加します。StringBufferappend(long lng)将long引数の文字列表現をこのシーケンスに追加します。StringBufferappend(CharSequence s)指定された〜をCharSequence追加到此序列。StringBufferappend(CharSequence s, int start, int end)指定された〜をCharSequence序列附加到此序列。StringBufferappend(Object obj)追加Object引数の文字列表現。StringBufferappend(String str)指定された文字列をこの文字シーケンスに追加します。StringBufferappend(StringBuffer sb)指定された〜をStringBuffer追加到此序列。StringBufferappendCodePoint(int codePoint)将codePoint引数の文字列表現をこのシーケンスに追加します。intcapacity()返回当前容量。charcharAt(int index)指定されたインデックスにある、このシーケンス内の...を返します。char值。IntStreamchars()返回intのストリームは、このシーケンス内のchar值进行零扩展。intcodePointAt(int index)指定されたインデックスの文字(Unicodeコードポイント)を返します。intcodePointBefore(int index)指定されたインデックスの前の文字(Unicodeコードポイント)を返します。intcodePointCount(int beginIndex, int endIndex)このシーケンスの指定されたテキスト範囲内のUnicodeコードポイント数を返します。IntStreamcodePoints()このシーケンス内のコードポイント値のストリームを返します。intcompareTo(StringBuffer another)StringBuffer字典顺序比较两个StringBuffer实例。StringBufferdelete(int start, int end)このシーケンスの部分文字列内の文字を削除します。StringBufferdeleteCharAt(int index)この順序で指定された位置の文字を削除するchar。voidensureCapacity(int minimumCapacity)容量が指定された最小値以上であることを保証します。voidgetChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)文字をこのシーケンスからターゲット文字配列にコピーします。dst。intindexOf(String str)指定された部分文字列が最初に出現する文字列内のインデックスを返します。intindexOf(String str, int fromIndex)指定されたインデックスから開始して、指定された部分文字列が最初に出現する文字列内のインデックスを返します。StringBufferinsert(int offset, boolean b)将boolean引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, char c)将char引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, char[] str)将char配列引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int index, char[] str, int offset, int len)将str配列引数の部分配列の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, double d)将double引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, float f)将float引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, int i)将第二个intパラメータの文字列表現をこのシーケンスに挿入します。StringBufferinsert(int offset, long l)将long引数の文字列表現をこのシーケンスに挿入します。StringBufferinsert(int dstOffset, CharSequence s)指定された〜をCharSequence插入此序列。StringBufferinsert(int dstOffset, CharSequence s, int start, int end)指定された〜をCharSequence序列插入此序列。StringBufferinsert(int offset, Object obj)将Objectパラメータの文字列表現をこの文字シーケンスに挿入します。StringBufferinsert(int offset, String str)将字符串插入此字符序列。intlastIndexOf(String str)指定された部分文字列が最後に出現する文字列内のインデックスを返します。intlastIndexOf(String str, int fromIndex)指定された部分文字列が最後に出現する文字列内のインデックスを、指定されたインデックスから後方に検索して返します。intoffsetByCodePoints(int index, int codePointOffset)指定された位置からこのシーケンス内のインデックスを返します。index偏移codePointOffset代码点。StringBufferreplace(int start, int end, String str)指定されたものを使ってStringの文字をこのシーケンスの部分文字列内の文字に置き換えます。StringBufferreverse()この文字シーケンスがシーケンスの逆順に置き換えられます。voidsetCharAt(int index, char ch)指定されたインデックスの文字を設定するch。voidsetLength(int newLength)文字シーケンスの長さを設定します。CharSequencesubSequence(int start, int end)このシーケンスの部分シーケンスである新しい文字シーケンスを返します。Stringsubstring(int start)新しい...を返すString、この文字シーケンスに現在含まれている文字の部分シーケンスを含むもの。Stringsubstring(int start, int end)新しい...を返すString、このシーケンスに現在含まれている文字の部分シーケンスを含みます。voidtrimToSize()文字シーケンス用の記憶容量を削減しようとします。-
メソッドを宣言しているクラス java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
メソッドを宣言しているインターフェース java.lang.CharSequence
chars, codePoints, length, toString
-
-
-
-
コンストラクタの詳細
-
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)
文字シーケンスの長さを設定します。 このシーケンスは、引数で指定された長さの新しい文字シーケンスに変更されます。 非負の各インデックス未満の場合knewLength、新しい文字シーケンスのインデックスで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- aboolean。 - 结果
- このオブジェクトへの参照。
-
append
public StringBuffer append(char c)
将char引数の文字列表現をこのシーケンスに追加します。この引数はこのシーケンスの内容に追加されます。 このシーケンスの長さが増加する
1。全体の効果はメソッドと
String.valueOf(char)引数を文字列に変換します完全相同、そしてその文字列内の文字はappended。- Specified by:
-
appendインターフェースでAppendable - 参数
-
c- achar。 - 结果
- このオブジェクトへの参照。
-
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- along。 - 结果
- このオブジェクトへの参照。
-
append
public StringBuffer append(float f)
将float引数の文字列表現をこのシーケンスに追加します。全体のな効果は、メソッドを介した場合と
String.valueOf(float)引数を文字列に変換します完全相同、その後、その文字列の文字がこの文字シーケンスのappended。- 参数
-
f- afloat。 - 结果
- このオブジェクトへの参照。
-
append
public StringBuffer append(double d)
将double引数の文字列表現をこのシーケンスに追加します。全体の効果はメソッドと
String.valueOf(double)引数を文字列に変換します完全相同、その後、この文字列の文字はappended。- 参数
-
d- adouble。 - 结果
- このオブジェクトへの参照。
-
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, end)このメソッドは、このクラスが実装できるようにするために提供されていますsb.substring(begin, 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开始,并扩展到lenchars。 部分配列の文字は、その位置におけるindex指示された位置にそのシーケンスを挿入します。 そのシーケンスの長さが増加しますlenchars。- 参数
-
index- サブ配列を挿入する位置。 -
str- Achar阵列。 -
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- オフセットが無効な場合。
- 如果k小于
-
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
- 如果k小于
-
insert
public StringBuffer insert(int offset, boolean b)
将boolean引数の文字列表現をこのシーケンスに挿入します。全体のな効果は、メソッドを介した場合と
String.valueOf(boolean)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted。offset参数必须大于或等于0、かつこのシーケンス以下length 。- 参数
-
offset- オフセット。 -
b- aboolean。 - 结果
- このオブジェクトへの参照。
- 异常
-
StringIndexOutOfBoundsException- オフセットが無効な場合。
-
insert
public StringBuffer insert(int offset, char c)
将char引数の文字列表現をこのシーケンスに挿入します。全体のな効果は、メソッドを介した場合と
String.valueOf(char)第2引数を文字列に変換します完全相同、その後、この文字列内の文字は指定されたオフセットでこの文字シーケンスに挿入されます。inserted。offset参数必须大于或等于0、かつこのシーケンス以下length 。- 参数
-
offset- 抵消。 -
c- achar。 - 结果
- このオブジェクトへの参照。
- 异常
-
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- along。 - 结果
- このオブジェクトへの参照。
- 异常
-
StringIndexOutOfBoundsException- オフセットが無効な場合。
-
insert
public StringBuffer insert(int offset, float f)
将float引数の文字列表現をこのシーケンスに挿入します。全体のな効果は、メソッドを介した場合と
String.valueOf(float)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセット位置でその文字シーケンスに入るinserted。offset参数必须大于或等于0、かつこのシーケンス以下length 。- 参数
-
offset- オフセット。 -
f- afloat。 - 结果
- このオブジェクトへの参照。
- 异常
-
StringIndexOutOfBoundsException- オフセットが無効な場合。
-
insert
public StringBuffer insert(int offset, double d)
将double引数の文字列表現をこのシーケンスに挿入します。全体のな効果は、メソッドを介した場合と
String.valueOf(double)第2引数を文字列に変換します完全相同、その後、この文字列の文字は指定されたオフセットでこの文字シーケンスのinserted。offset参数必须大于或等于0、かつこのシーケンス以下length 。- 参数
-
offset- 抵消。 -
d- adouble。 - 结果
- このオブジェクトへの参照。
- 异常
-
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
-
-