Java常用API 之 java.lang.StringBuilder（附解析和示例）_12

2

public final class StringBuilder
extends Object
implements Serializable, CharSequence

    java.lang.StringBuilder是一個可變的字符序列。StringBuilder類提供一個與 StringBuffer 兼容的 API，但不保證同步。該類被設計用作 StringBuffer 的一個簡易替換，用在字符串緩衝區被單個線程使用的時候（這種情況很普遍）。如果可能，建議優先採用該類，因爲在大多數實現中，它比 StringBuffer 要快。

    在 StringBuilder 上的主要操作是 append 和 insert 方法，可重載這些方法，以接受任意類型的數據。每個方法都能有效地將給定的數據轉換成字符串，然後將該字符串的字符添加或插入到字符串生成器中。append 方法始終將這些字符添加到生成器的末端；而 insert 方法則在指定的點添加字符。

    通常，如果 sb 引用 StringBuilder 的實例，則 sb.append(x) 和 sb.insert(sb.length(), x) 具有相同的效果。 每個字符串生成器都有一定的容量。只要字符串生成器所包含的字符序列的長度沒有超出此容量，就無需分配新的內部緩衝區。如果內部緩衝區溢出，則此容量自動增大。

    將 StringBuilder 的實例用於多個線程是不安全的。如果需要這樣的同步，則建議使用 StringBuffer，StringBuffer是線程安全的。

構造函數

StringBuilder( )	構造一個其中不帶字符的字符串生成器，初始容量爲 16 個字符。
StringBuilder(String str)	構造一個字符串生成器，並初始化爲指定的字符串內容。

對象方法

public StringBuilder append(Object obj)	將對象以字符串的形式添加到StringBuilder去。 添加的是String.valueOf（obj）返回的字符串。
public StringBuilder delete(int start,                             int end)	從StringBuilder中刪除由索引指定的字符串序列
public StringBuilder deleteCharAt(int index)	從StringBuilder中刪除有索引指定的字符
public StringBuilder replace(int start, int end,String str)	從StringBuilder中替換由索引指定的字符串序列
public StringBuilder insert(int offset, Object obj)	public StringBuilder insert(int offset, Object obj)
public int indexOf(String str)	返回在StringBuilder中第一次出現str字符串的位置
public int indexOf(String str, int fromIndex)	返回在StringBuilder中指定索引之後第一次出現str字符串的位置
public int lastIndexOf(String str)	返回在StringBuilder中最後一次出現str字符串的位置
public StringBuilder reverse()	反轉字符串
public String toString()	將StringBuilder轉換成String

public int length()	返回StringBuilder中字符的長度
public int capacity()	返回StringBuilder當前的容量
public char charAt(int index)	返回StringBuilder中指定位置的字符
public void setCharAt(int index,char ch)	在指定索引處的字符被設置爲ch。
public String substring(int start, int end)	返回StringBuilder的字串