- 相關(guān)軟件
>StringBuffer 創(chuàng)建者：webmaster 更新時(shí)間：2005-12-17 03:24字符串緩沖區(qū)可以被多個(gè)線程安全地使用。 這些方法在需要的時(shí)侯可以同步執(zhí)行，因而任一特定實(shí)例的所有操作就好象是以串行的次序發(fā)生 。
字符串緩沖區(qū)被編譯器用來(lái)實(shí)現(xiàn)連接兩個(gè)字符串的運(yùn)算符+。 例如，代碼：
x = "a" + 4 + "c"
被編譯成等價(jià)的：
x = new StringBuffer().append("a").append(4).append("c")
.toString()
在StringBuffer上的基本操作是append和insert方法，它們都被覆蓋以接受任意類型的數(shù)據(jù)。
每個(gè)方法都迅速地把所給的數(shù)據(jù)轉(zhuǎn)換成一個(gè)字符串，并且把該字符串的字符添加或插入
到字符串緩沖區(qū)中。
append方法常常把這些字符添加到緩沖區(qū)的末端；
而insert方法則把這些字符添加到指定的地方 。
例如，如果z指的是一個(gè)字符串緩沖區(qū)內(nèi)的對(duì)象 ，其當(dāng)前的內(nèi)容是 "start"，于是通過(guò)調(diào)用方法z.append("le")會(huì)使字符串緩沖區(qū)的內(nèi)容變成"startle"，而
z.insert(4, "le")將使緩沖區(qū)的內(nèi)容變成
"starlet"。
每一個(gè)字符串緩沖區(qū)都有一定的容量。 只要字符串緩沖區(qū)存儲(chǔ)的字符序列的
長(zhǎng)度沒(méi)有超過(guò)它的容量，就無(wú)須申請(qǐng)新的內(nèi)部緩沖數(shù)組 。
如果內(nèi)部的緩沖區(qū)溢出，它將自動(dòng)加以擴(kuò)大。
類 java.lang.StringBuffer
java.lang.Object
|
+----java.lang.StringBuffer- public final class StringBuffer
- extends Object
- implements Serializable
- extends Object
字符串緩沖區(qū)實(shí)現(xiàn)可變字符序列。
- 來(lái)自：
- JDK1.0
- 參見：
- ByteArrayOutputStream, String
構(gòu)造子索引- StringBuffer()
- 構(gòu)造一個(gè)不包含字符的字符串緩沖區(qū)，其初始的容量設(shè)為 16 個(gè)字符。
- StringBuffer(int)
- 構(gòu)造一個(gè)不包含字符的字符串緩沖區(qū)，其初始容量由參數(shù)
length設(shè)定。 - StringBuffer(String)
- 構(gòu)造一個(gè)字符串緩沖區(qū)，使它表示和字符串參數(shù)相同的字符序列。
方法索引- append(boolean)
- 把
boolean型參數(shù)的字符串表示添加到字符串緩沖區(qū)。
- append(char)
- 把
char型參數(shù)的字符串表示添加到字符串緩沖區(qū)。 - append(char[])
- 把
char型數(shù)組參數(shù)的字符串表示添加到字符串緩沖區(qū)。 - append(char[], int, int)
- 把
char型數(shù)組參數(shù)的子數(shù)組的字符串表示添加到字符串緩沖區(qū)。 - append(double)
- 把
double型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - append(float)
- 把
float型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - append(int)
- 把
int型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - append(long)
- 把
long型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
- append(Object)
- 把
Object型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - append(String)
- 添加字符串到字符串緩沖區(qū)。
- capacity()
- 返回字符串緩沖區(qū)的當(dāng)前容量。
- charAt(int)
- 返回字符串緩沖區(qū)中特定位置的字符。
- ensureCapacity(int)
- 保證緩沖區(qū)的容量至少等于指定的最小數(shù)。
- getChars(int, int, char[], int)
- 把字符從字符串緩沖區(qū)拷貝到目標(biāo)字符數(shù)組
dst。 - insert(int, boolean)
- 把
boolean型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - insert(int, char)
- 把
char型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - insert(int, char[])
- 把
char型數(shù)組參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - insert(int, double)
- 把
double型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - insert(int, float)
- 把
float型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。 - insert(int, int)
- 把第二個(gè)
int型參數(shù)表示的字符串插入到該字符串緩沖區(qū)。 - insert(int, long)
- 把
long型參數(shù)的字符串表示插入到該字符串緩沖區(qū)。 - insert(int, Object)
- 把
Object型參數(shù)的字符串表示插入到該字符串緩沖區(qū)。 - insert(int, String)
- 把字符串插入到字符串緩沖區(qū)。
- length()
- 返回字符串緩沖區(qū)的長(zhǎng)度 (字符數(shù))。
- reverse()
- 把字符串緩沖區(qū)的字符序列用其反向字符序列替換。
- setCharAt(int, char)
- 字符串緩沖區(qū)指定位置的字符設(shè)置為
ch。 - setLength(int)
- 設(shè)置字符串緩沖區(qū)的長(zhǎng)度。
- toString()
- 把字符串緩沖區(qū)的數(shù)據(jù)轉(zhuǎn)換為字符串表示。
構(gòu)造子
StringBuffer
public StringBuffer()- 構(gòu)造一個(gè)不包含字符的字符串緩沖區(qū)，其初始的容量設(shè)為 16 個(gè)字符。
StringBuffer
public StringBuffer(int length)- 構(gòu)造一個(gè)不包含字符的字符串緩沖區(qū)，其初始的容量由參數(shù)
length設(shè)置。
- 參數(shù)：
- length - 初始的容量。
- 拋出：
NegativeArraySizeException
- 如果參數(shù)
length小于0。
StringBuffer
public StringBuffer(String str)- 構(gòu)造一個(gè)字符串緩沖區(qū)，來(lái)表示和字符串參數(shù)相同的字符序列。 字符串緩沖區(qū)的初始容量
為16加上字符串參數(shù)的長(zhǎng)度。
- 參數(shù)：
- str - 緩沖區(qū)的初始內(nèi)容 。
方法
length
public int length()- 返回字符串緩沖區(qū)的長(zhǎng)度 (字符數(shù))。
- 返回：
- 字符串緩沖區(qū)的字符數(shù)。
capacity
public int capacity()- 返回字符串緩沖區(qū)的當(dāng)前容量。 該容量表示可用于插入新的字符的存儲(chǔ)空間；超出該容量時(shí)會(huì)發(fā)生新的容量分配。
- 返回：
- 字符串緩沖區(qū)的當(dāng)前容量。
ensureCapacity
public synchronized void ensureCapacity(int minimumCapacity)- 保證緩沖區(qū)的容量至少等于指定的最小數(shù)。
如果字符串緩沖區(qū)的當(dāng)前容量少于該參數(shù)，則分配一個(gè)新的更大的內(nèi)部緩沖區(qū)。
新容量將取如下參數(shù)中較大的一個(gè)：
- 參數(shù)
minimumCapacity。
- 舊容量的兩倍加
2.
如果參數(shù)minimumCapacity非正，該方法不作任何操作，只簡(jiǎn)單地返回。
- 參數(shù)：
- minimumCapacity - 要求的最小容量。
- 參數(shù)
setLength
public synchronized void setLength(int newLength)- 設(shè)置該字符串緩沖區(qū)的長(zhǎng)度。
如果參數(shù)newLength小于該字符串緩沖區(qū)的當(dāng)前長(zhǎng)度。
該字符串緩沖區(qū)將被截?cái)鄟?lái)包含恰好等于由參數(shù)newLength給出的字符數(shù)。
如果參數(shù)newLength大于或等于當(dāng)前的長(zhǎng)度，就用 null 字符 ('\u0000')補(bǔ)齊該字符串緩沖區(qū)，以使長(zhǎng)度變?yōu)閰?shù)newLength指定的長(zhǎng)度。
參數(shù)newLength必須大于或等于0。
- 參數(shù)：
- newLength - 緩沖區(qū)的新建長(zhǎng)度 。
- 拋出：
StringIndexOutOfBoundsException
- 如果參數(shù)
newLength是 非法的。
- 參見：
- length
charAt
public synchronized char charAt(int index)- 返回在字符串緩沖區(qū)特定位置的字符。
字符串緩沖區(qū)的第一個(gè)字符的索引是0，下一個(gè)的索引是1，對(duì)于索引數(shù)組依次類推。
偏移參量必須大于或等于0，但是小于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- index - 期望的字符的索引。
- 返回：
- 該字符串緩沖區(qū)指定位置的字符。
- 拋出：
StringIndexOutOfBoundsException
- 如果索引無(wú)效。
- 參見：
- length
getChars
public synchronized void getChars(int srcBegin,
int srcEnd,
char dst[],
int dstBegin)- 把字符從該字符串緩沖區(qū)拷貝到目標(biāo)字符數(shù)組
dst。 第一個(gè)要復(fù)制的字符在下標(biāo)srcBegin； 最后一個(gè)要復(fù)制的字符在下標(biāo)srcEnd-1。 要復(fù)制的字符總數(shù)是
srcEnd-srcBegin。 要復(fù)制到dst子數(shù)組的字符開始于下標(biāo)dstBegin，結(jié)束于下標(biāo)
dstbegin + (srcEnd-srcBegin) - 1
- 參數(shù)：
- srcBegin - 在字符串緩沖區(qū)開始復(fù)制的偏移量 。
- srcEnd - 在字符串緩沖區(qū)停止復(fù)制的偏移量 。
- dst - 數(shù)據(jù)將復(fù)制到的數(shù)組。
- dstBegin -
dst的偏移量。
- srcEnd - 在字符串緩沖區(qū)停止復(fù)制的偏移量 。
- 拋出：
StringIndexOutOfBoundsException
- 如果有一個(gè)對(duì)該緩沖區(qū)無(wú)效的索引 。
setCharAt
public synchronized void setCharAt(int index,
char ch)- 將該字符串緩沖區(qū)指定位置的字符被設(shè)置成
ch。
偏移參量必須大于或等于0，但小于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- index - 要修改的字符的索引。
- ch - 新的字符。
- ch - 新的字符。
- 拋出：
StringIndexOutOfBoundsException
- 如果索引無(wú)效。
- 參見：
- length
append
public synchronized StringBuffer append(Object obj)- 把
Object型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)。
append
public synchronized StringBuffer append(String str)- 添加該字符串到字符串緩沖區(qū)。
把參數(shù)String的字符依次添加到字符串緩沖區(qū)中，字符串緩沖區(qū)長(zhǎng)度的增加值為該參數(shù)的長(zhǎng)度。
- 參數(shù)：
- str - 一字符串。
- 返回：
- 字符串緩沖區(qū)。
append
public synchronized StringBuffer append(char str[])- 把
char型數(shù)組參數(shù)的字符串表示添加到字符串緩沖區(qū)。
把數(shù)組參數(shù)的字符依次添加到字符串緩沖區(qū)中。
字符串緩沖區(qū)的長(zhǎng)度的增加值為參數(shù)的長(zhǎng)度。
- 參數(shù)：
- str - 將添加的字符。
- 返回：
- 字符串緩沖區(qū)。
append
public synchronized StringBuffer append(char str[],
int offset,
int len)- 把
char型數(shù)組參數(shù)的子數(shù)組的字符串表示添加到字符串緩沖區(qū)。
把字符數(shù)組str從下標(biāo)offset開始的字符，依次添加到了字符串緩沖區(qū)的內(nèi)容中。
該字符串緩沖區(qū)的長(zhǎng)度增加了
len。
- 參數(shù)：
- str - 將添加的字符。
- offset - 要添加的第一個(gè)字符的下標(biāo)。
- len - 添加的字符數(shù)
- offset - 要添加的第一個(gè)字符的下標(biāo)。
- 返回：
- 字符串緩沖區(qū)。
append
public StringBuffer append(boolean b)- 把
boolean型參數(shù)的字符串表示添加到字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符接著也添加到了字符串緩沖區(qū)。
append
public synchronized StringBuffer append(char c)- 把
char型參數(shù)的字符串表示添加到字符串緩沖區(qū)。
參數(shù)添加到字符串緩沖區(qū)的內(nèi)容中。
字符串緩沖區(qū)的長(zhǎng)度增加了1。
- 參數(shù)：
- ch - 一個(gè)
char。
- 返回：
- 字符串緩沖區(qū)。
append
public StringBuffer append(int i)- 把
int型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)。
append
public StringBuffer append(long l)- 把
long型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)。
append
public StringBuffer append(float f)- 把
float型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)。
append
public StringBuffer append(double d)- 把
double型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)。
insert
public synchronized StringBuffer insert(int offset,
Object obj)- 把
Object型參數(shù)的字符串表示插入到字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被插入到字符串緩沖區(qū)的指定偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
Object.
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
insert
public synchronized StringBuffer insert(int offset,
String str)- 把該字符串插入到該字符串緩沖區(qū)。
參數(shù)String的字符依次插入到字符串緩沖區(qū)的指定偏移位置。
字符串緩沖區(qū)的長(zhǎng)度的增加值為參數(shù)的長(zhǎng)度。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- str - 一個(gè)字符串。
- str - 一個(gè)字符串。
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- length
insert
public synchronized StringBuffer insert(int offset,
char str[])- 把
char型數(shù)組參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
把數(shù)組參數(shù)的字符添加到字符串緩沖區(qū)里由offset指定的位置。 字符串緩沖區(qū)長(zhǎng)度的增加值為參數(shù)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- ch - 一個(gè)字符數(shù)組。
- ch - 一個(gè)字符數(shù)組。
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
insert
public StringBuffer insert(int offset,
boolean b)- 把
boolean型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符被添加到了字符串緩沖區(qū)指定的偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
boolean量。
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
insert
public synchronized StringBuffer insert(int offset,
char c)- 把
char型參數(shù)的字符串表示添加到該字符串緩沖區(qū)。
把第二個(gè)參數(shù)表示的字符插入到字符串緩沖區(qū)里由offset指定的位置。 字符串緩沖區(qū)的長(zhǎng)度增加了 1 。
偏移參量必須大于或等于
0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- ch - 一個(gè)
char。
- ch - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- length
insert
public StringBuffer insert(int offset,
int i)- 把第二個(gè)
int型參數(shù)的字符串表示插入到該字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)指定的偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
int.
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
insert
public StringBuffer insert(int offset,
long l)- 把
long型參數(shù)的字符串表示插入到該字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)指定的偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
long.
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
insert
public StringBuffer insert(int offset,
float f)- 把參數(shù)
float的字符串表示添加到該字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)指定的偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
float.
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
insert
public StringBuffer insert(int offset,
double d)- 把參數(shù)
double的字符串表示添加到該字符串緩沖區(qū)。
第二個(gè)參數(shù)先轉(zhuǎn)換成一個(gè)字符串，就好象通過(guò)String.valueOf方法一樣，并且該字符串的字符隨后被添加到了字符串緩沖區(qū)指定的偏移位置。
偏移參量必須大于或等于0，小于或等于字符串緩沖區(qū)的長(zhǎng)度。
- 參數(shù)：
- offset - 偏移量。
- b - 一個(gè)
double.
- b - 一個(gè)
- 返回：
- 字符串緩沖區(qū)。
- 拋出：
StringIndexOutOfBoundsException
- 如果偏移無(wú)效。
- 參見：
- valueOf, insert, length
reverse
public synchronized StringBuffer reverse()- 該字符串緩沖區(qū)的字符序列被其反向字符序列所替換。
- 返回：
- 字符串緩沖區(qū)。
toString
public String toString()- 轉(zhuǎn)換為一個(gè)表示該字符串緩沖區(qū)數(shù)據(jù)的字符串。
分配一個(gè)新的String對(duì)象，并且用字符串緩沖區(qū)所表示的字符序列進(jìn)行初始化。
于是此String被返回。 隨后緩沖區(qū)發(fā)生的變化不再影響該String的內(nèi)容。
- 返回：
- 字符串緩沖區(qū)的字符串表示法。
- 覆蓋：
- 類 Object 中的
toString
本頁(yè)查看次數(shù): - public final class StringBuffer