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的字串