Java中StringBuilder字符串类型的操作方法及API整理

0.stringbuilder类型简介
stringbuilder类型是一个可变的字符串类型，stringbuilder类型的api与stringbuffer类型的api基本一致，唯一的区别是stringbuilder的使用假设在单一线程中，换句话说，stringbuilder是线程不安全的。stringbuilder在实例化的时候，通常也会默认设定一个容量大小，一般为字符串参数的长度+16。stringbuilder是继承abstractstringbuilder这个抽象类的，而这个抽象类的内部使用字符数组来实现的，数组可以进行动态扩展。stringbuilder类提供的常用的方法有append()、insert()、replace()、deletecharat()、indexof()、reverse()、tostring()等方法，可以实现字符串的增删改查等基本功能。

package date0812.demo1;

public class test3 {

  public static void main(string[] args) {
    stringbuilder stringbuilder = new stringbuilder("eclipse");
    //添加
    stringbuilder = stringbuilder.append(" software");
    //容量
    int c = stringbuilder.capacity();
    //翻转
    stringbuilder= stringbuilder.reverse();
    system.out.println(c);
    system.out.println(stringbuilder);
  }
}

运行结果：

23
erawtfos espilce

1. stringbuilder的方法
stringbuilder 是一个可变的字符序列。它继承于abstractstringbuilder，实现了charsequence接口。
stringbuffer 也是继承于abstractstringbuilder的子类；但是，stringbuilder和stringbuffer不同，前者是非线程安全的，后者是线程安全的。
stringbuilder 和 charsequence之间的关系图如下：

stringbuilder方法列表：

stringbuilder()
stringbuilder(int capacity)
stringbuilder(charsequence seq)
stringbuilder(string str)

stringbuilder   append(float f)
stringbuilder   append(double d)
stringbuilder   append(boolean b)
stringbuilder   append(int i)
stringbuilder   append(long l)
stringbuilder   append(char c)
stringbuilder   append(char[] chars)
stringbuilder   append(char[] str, int offset, int len)
stringbuilder   append(string str)
stringbuilder   append(object obj)
stringbuilder   append(stringbuffer sb)
stringbuilder   append(charsequence csq)
stringbuilder   append(charsequence csq, int start, int end)
stringbuilder   appendcodepoint(int codepoint)
int   capacity()
char   charat(int index)
int   codepointat(int index)
int   codepointbefore(int index)
int   codepointcount(int start, int end)
stringbuilder   delete(int start, int end)
stringbuilder   deletecharat(int index)
void   ensurecapacity(int min)
void   getchars(int start, int end, char[] dst, int dststart)
int   indexof(string substring, int start)
int   indexof(string string)
stringbuilder   insert(int offset, boolean b)
stringbuilder   insert(int offset, int i)
stringbuilder   insert(int offset, long l)
stringbuilder   insert(int offset, float f)
stringbuilder   insert(int offset, double d)
stringbuilder   insert(int offset, char c)
stringbuilder   insert(int offset, char[] ch)
stringbuilder   insert(int offset, char[] str, int stroffset, int strlen)
stringbuilder   insert(int offset, string str)
stringbuilder   insert(int offset, object obj)
stringbuilder   insert(int offset, charsequence s)
stringbuilder   insert(int offset, charsequence s, int start, int end)
int   lastindexof(string string)
int   lastindexof(string substring, int start)
int   length()
int   offsetbycodepoints(int index, int codepointoffset)
stringbuilder   replace(int start, int end, string string)
stringbuilder   reverse()
void   setcharat(int index, char ch)
void   setlength(int length)
charsequence   subsequence(int start, int end)
string   substring(int start)
string   substring(int start, int end)
string   tostring()
void   trimtosize()

由于abstractstringbuilder和stringbuilder源码太长，这里就不列出源码了。感兴趣的读者可以自行研究。

2. stringbuilder的api测试代码
2.1 stringbuilder 中插入(insert)相关的api
源码如下(stringbuilderinserttest.java):

/**
 * stringbuilder 的insert()示例
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderinserttest {

  public static void main(string[] args) {
    testinsertapis() ;
  }

  /**
   * stringbuilder 的insert()示例
   */
  private static void testinsertapis() {

    system.out.println("-------------------------------- testinsertapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder();

    // 在位置0处插入字符数组
    sbuilder.insert(0, new char[]{'a','b','c','d','e'});
    // 在位置0处插入字符数组。0表示字符数组起始位置，3表示长度
    sbuilder.insert(0, new char[]{'a','b','c','d','e'}, 0, 3);
    // 在位置0处插入float
    sbuilder.insert(0, 1.414f);
    // 在位置0处插入double
    sbuilder.insert(0, 3.14159d);
    // 在位置0处插入boolean
    sbuilder.insert(0, true);
    // 在位置0处插入char
    sbuilder.insert(0, '\n');
    // 在位置0处插入int
    sbuilder.insert(0, 100);
    // 在位置0处插入long
    sbuilder.insert(0, 12345l);
    // 在位置0处插入stringbuilder对象
    sbuilder.insert(0, new stringbuilder("stringbuilder"));
    // 在位置0处插入stringbuilder对象。6表示被在位置0处插入对象的起始位置(包括)，13是结束位置(不包括)
    sbuilder.insert(0, new stringbuilder("stringbuilder"), 6, 13);
    // 在位置0处插入stringbuffer对象。
    sbuilder.insert(0, new stringbuffer("stringbuffer"));
    // 在位置0处插入stringbuffer对象。6表示被在位置0处插入对象的起始位置(包括)，12是结束位置(不包括)
    sbuilder.insert(0, new stringbuffer("stringbuffer"), 6, 12);
    // 在位置0处插入string对象。
    sbuilder.insert(0, "string");
    // 在位置0处插入string对象。1表示被在位置0处插入对象的起始位置(包括)，6是结束位置(不包括)
    sbuilder.insert(0, "0123456789", 1, 6);
    sbuilder.insert(0, '\n');

    // 在位置0处插入object对象。此处以hashmap为例
    hashmap map = new hashmap();
    map.put("1", "one");
    map.put("2", "two");
    map.put("3", "three");
    sbuilder.insert(0, map);

    system.out.printf("%s\n\n", sbuilder);
  }
}

运行结果：

-------------------------------- testinsertapis -------------------------------
{3=three, 2=two, 1=one}
12345stringbufferstringbufferbuilderstringbuilder12345100
true3.141591.414abcabcde

2.2 stringbuilder 中追加(append)相关的api
源码如下(stringbuilderappendtest.java):

/**
 * stringbuilder 的append()示例
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderappendtest {

  public static void main(string[] args) {
    testappendapis() ;
  }

  /**
   * stringbuilder 的append()示例
   */
  private static void testappendapis() {

    system.out.println("-------------------------------- testappendapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder();

    // 追加字符数组
    sbuilder.append(new char[]{'a','b','c','d','e'});
    // 追加字符数组。0表示字符数组起始位置，3表示长度
    sbuilder.append(new char[]{'a','b','c','d','e'}, 0, 3);
    // 追加float
    sbuilder.append(1.414f);
    // 追加double
    sbuilder.append(3.14159d);
    // 追加boolean
    sbuilder.append(true);
    // 追加char
    sbuilder.append('\n');
    // 追加int
    sbuilder.append(100);
    // 追加long
    sbuilder.append(12345l);
    // 追加stringbuilder对象
    sbuilder.append(new stringbuilder("stringbuilder"));
    // 追加stringbuilder对象。6表示被追加对象的起始位置(包括)，13是结束位置(不包括)
    sbuilder.append(new stringbuilder("stringbuilder"), 6, 13);
    // 追加stringbuffer对象。
    sbuilder.append(new stringbuffer("stringbuffer"));
    // 追加stringbuffer对象。6表示被追加对象的起始位置(包括)，12是结束位置(不包括)
    sbuilder.append(new stringbuffer("stringbuffer"), 6, 12);
    // 追加string对象。
    sbuilder.append("string");
    // 追加string对象。1表示被追加对象的起始位置(包括)，6是结束位置(不包括)
    sbuilder.append("0123456789", 1, 6);
    sbuilder.append('\n');

    // 追加object对象。此处以hashmap为例
    hashmap map = new hashmap();
    map.put("1", "one");
    map.put("2", "two");
    map.put("3", "three");
    sbuilder.append(map);
    sbuilder.append('\n');

    // 追加unicode编码
    sbuilder.appendcodepoint(0x5b57);  // 0x5b57是“字”的unicode编码
    sbuilder.appendcodepoint(0x7b26);  // 0x7b26是“符”的unicode编码
    sbuilder.appendcodepoint(0x7f16);  // 0x7f16是“编”的unicode编码
    sbuilder.appendcodepoint(0x7801);  // 0x7801是“码”的unicode编码

    system.out.printf("%s\n\n", sbuilder);
  }
}

运行结果：

-------------------------------- testappendapis -------------------------------
abcdeabc1.4143.14159true
10012345stringbuilderbuilderstringbufferbufferstring12345
{3=three, 2=two, 1=one}
字符编码

2.3 stringbuilder 中替换(replace)相关的api
源码如下(stringbuilderreplacetest.java):

/**
 * stringbuilder 的replace()示例
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderreplacetest {

  public static void main(string[] args) {
    testreplaceapis() ;
  }

  /**
   * stringbuilder 的replace()示例
   */
  private static void testreplaceapis() {

    system.out.println("-------------------------------- testreplaceapis ------------------------------");

    stringbuilder sbuilder;

    sbuilder = new stringbuilder("0123456789");
    sbuilder.replace(0, 3, "abcde");
    system.out.printf("sbuilder=%s\n", sbuilder);

    sbuilder = new stringbuilder("0123456789");
    sbuilder.reverse();
    system.out.printf("sbuilder=%s\n", sbuilder);

    sbuilder = new stringbuilder("0123456789");
    sbuilder.setcharat(0, 'm');
    system.out.printf("sbuilder=%s\n", sbuilder);

    system.out.println();
  }
}

运行结果：

-------------------------------- testreplaceapis ------------------------------
sbuilder=abcde3456789
sbuilder=9876543210
sbuilder=m123456789

2.4 stringbuilder 中删除(delete)相关的api
源码如下(stringbuilderdeletetest.java):

/**
 * stringbuilder 的delete()示例
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderdeletetest {

  public static void main(string[] args) {
    testdeleteapis() ;
  }

  /**
   * stringbuilder 的delete()示例
   */
  private static void testdeleteapis() {

    system.out.println("-------------------------------- testdeleteapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder("0123456789");

    // 删除位置0的字符，剩余字符是“123456789”。
    sbuilder.deletecharat(0);
    // 删除位置3(包括)到位置6(不包括)之间的字符，剩余字符是“123789”。
    sbuilder.delete(3,6);

    // 获取sb中从位置1开始的字符串
    string str1 = sbuilder.substring(1);
    // 获取sb中从位置3(包括)到位置5(不包括)之间的字符串
    string str2 = sbuilder.substring(3, 5);
    // 获取sb中从位置3(包括)到位置5(不包括)之间的字符串，获取的对象是charsequence对象，此处转型为string
    string str3 = (string)sbuilder.subsequence(3, 5);

    system.out.printf("sbuilder=%s\nstr1=%s\nstr2=%s\nstr3=%s\n", 
        sbuilder, str1, str2, str3);
  }
}

运行结果：

-------------------------------- testdeleteapis -------------------------------
sbuilder=123789
str1=23789
str2=78
str3=78

2.5 stringbuilder 中index相关的api
源码如下(stringbuilderindextest.java):

/**
 * stringbuilder 中index相关api演示
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderindextest {

  public static void main(string[] args) {
    testindexapis() ;
  }

  /**
   * stringbuilder 中index相关api演示
   */
  private static void testindexapis() {
    system.out.println("-------------------------------- testindexapis --------------------------------");

    stringbuilder sbuilder = new stringbuilder("abcabcabcabcabcabcabcabc");
    system.out.printf("sbuilder=%s\n", sbuilder);

    // 1. 从前往后，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.indexof(\"bc\")", sbuilder.indexof("bc"));

    // 2. 从位置5开始，从前往后，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.indexof(\"bc\", 5)", sbuilder.indexof("bc", 5));

    // 3. 从后往前，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.lastindexof(\"bc\")", sbuilder.lastindexof("bc"));

    // 4. 从位置4开始，从后往前，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.lastindexof(\"bc\", 4)", sbuilder.lastindexof("bc", 4));

    system.out.println();
  }
}

运行结果：

-------------------------------- testindexapis --------------------------------
sbuilder=abcabcabcabcabcabcabcabc
sbuilder.indexof("bc")     = 1
sbuilder.indexof("bc", 5)   = 22
sbuilder.lastindexof("bc")   = 22
sbuilder.lastindexof("bc", 4) = 4

2.6 stringbuilder 剩余的api
源码如下(stringbuilderothertest.java):

/**
 * stringbuilder 的其它api示例
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuilderothertest {

  public static void main(string[] args) {
    testotherapis() ;
  }

  /**
   * stringbuilder 的其它api示例
   */
  private static void testotherapis() {

    system.out.println("-------------------------------- testotherapis --------------------------------");

    stringbuilder sbuilder = new stringbuilder("0123456789");

    int cap = sbuilder.capacity();
    system.out.printf("cap=%d\n", cap);

    char c = sbuilder.charat(6);
    system.out.printf("c=%c\n", c);

    char[] carr = new char[4];
    sbuilder.getchars(3, 7, carr, 0);
    for (int i=0; i<carr.length; i++)
      system.out.printf("carr[%d]=%c ", i, carr[i]);
    system.out.println();

    system.out.println();
  }
}

运行结果：

-------------------------------- testotherapis --------------------------------
cap=26
c=6
carr[0]=3 carr[1]=4 carr[2]=5 carr[3]=6 

3. stringbuilder 完整示例
下面的示例是整合上面的几个示例的完整的stringbuilder演示程序，源码如下(stringbuildertest.java):

/**
 * stringbuilder 演示程序
 *
 * @author skywang
 */
import java.util.hashmap;

public class stringbuildertest {

  public static void main(string[] args) {
    testotherapis() ;
    testindexapis() ;
    testinsertapis() ;
    testappendapis() ;
    testreplaceapis() ;
    testdeleteapis() ;
  }

  /**
   * stringbuilder 的其它api示例
   */
  private static void testotherapis() {

    system.out.println("-------------------------------- testotherapis --------------------------------");

    stringbuilder sbuilder = new stringbuilder("0123456789");

    int cap = sbuilder.capacity();
    system.out.printf("cap=%d\n", cap);

    char c = sbuilder.charat(6);
    system.out.printf("c=%c\n", c);

    char[] carr = new char[4];
    sbuilder.getchars(3, 7, carr, 0);
    for (int i=0; i<carr.length; i++)
      system.out.printf("carr[%d]=%c ", i, carr[i]);
    system.out.println();

    system.out.println();
  }

  /**
   * stringbuilder 中index相关api演示
   */
  private static void testindexapis() {
    system.out.println("-------------------------------- testindexapis --------------------------------");

    stringbuilder sbuilder = new stringbuilder("abcabcabcabcabcabcabcabc");
    system.out.printf("sbuilder=%s\n", sbuilder);

    // 1. 从前往后，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.indexof(\"bc\")", sbuilder.indexof("bc"));

    // 2. 从位置5开始，从前往后，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.indexof(\"bc\", 5)", sbuilder.indexof("bc", 5));

    // 3. 从后往前，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.lastindexof(\"bc\")", sbuilder.lastindexof("bc"));

    // 4. 从位置4开始，从后往前，找出"bc"第一次出现的位置
    system.out.printf("%-30s = %d\n", "sbuilder.lastindexof(\"bc\", 4)", sbuilder.lastindexof("bc", 4));

    system.out.println();
  }

  /**
   * stringbuilder 的replace()示例
   */
  private static void testreplaceapis() {

    system.out.println("-------------------------------- testreplaceapis ------------------------------");

    stringbuilder sbuilder;

    sbuilder = new stringbuilder("0123456789");
    sbuilder.replace(0, 3, "abcde");
    system.out.printf("sbuilder=%s\n", sbuilder);

    sbuilder = new stringbuilder("0123456789");
    sbuilder.reverse();
    system.out.printf("sbuilder=%s\n", sbuilder);

    sbuilder = new stringbuilder("0123456789");
    sbuilder.setcharat(0, 'm');
    system.out.printf("sbuilder=%s\n", sbuilder);

    system.out.println();
  }

  /**
   * stringbuilder 的delete()示例
   */
  private static void testdeleteapis() {

    system.out.println("-------------------------------- testdeleteapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder("0123456789");

    // 删除位置0的字符，剩余字符是“123456789”。
    sbuilder.deletecharat(0);
    // 删除位置3(包括)到位置6(不包括)之间的字符，剩余字符是“123789”。
    sbuilder.delete(3,6);

    // 获取sb中从位置1开始的字符串
    string str1 = sbuilder.substring(1);
    // 获取sb中从位置3(包括)到位置5(不包括)之间的字符串
    string str2 = sbuilder.substring(3, 5);
    // 获取sb中从位置3(包括)到位置5(不包括)之间的字符串，获取的对象是charsequence对象，此处转型为string
    string str3 = (string)sbuilder.subsequence(3, 5);

    system.out.printf("sbuilder=%s\nstr1=%s\nstr2=%s\nstr3=%s\n", 
        sbuilder, str1, str2, str3);
  }

  /**
   * stringbuilder 的insert()示例
   */
  private static void testinsertapis() {

    system.out.println("-------------------------------- testinsertapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder();

    // 在位置0处插入字符数组
    sbuilder.insert(0, new char[]{'a','b','c','d','e'});
    // 在位置0处插入字符数组。0表示字符数组起始位置，3表示长度
    sbuilder.insert(0, new char[]{'a','b','c','d','e'}, 0, 3);
    // 在位置0处插入float
    sbuilder.insert(0, 1.414f);
    // 在位置0处插入double
    sbuilder.insert(0, 3.14159d);
    // 在位置0处插入boolean
    sbuilder.insert(0, true);
    // 在位置0处插入char
    sbuilder.insert(0, '\n');
    // 在位置0处插入int
    sbuilder.insert(0, 100);
    // 在位置0处插入long
    sbuilder.insert(0, 12345l);
    // 在位置0处插入stringbuilder对象
    sbuilder.insert(0, new stringbuilder("stringbuilder"));
    // 在位置0处插入stringbuilder对象。6表示被在位置0处插入对象的起始位置(包括)，13是结束位置(不包括)
    sbuilder.insert(0, new stringbuilder("stringbuilder"), 6, 13);
    // 在位置0处插入stringbuffer对象。
    sbuilder.insert(0, new stringbuffer("stringbuffer"));
    // 在位置0处插入stringbuffer对象。6表示被在位置0处插入对象的起始位置(包括)，12是结束位置(不包括)
    sbuilder.insert(0, new stringbuffer("stringbuffer"), 6, 12);
    // 在位置0处插入string对象。
    sbuilder.insert(0, "string");
    // 在位置0处插入string对象。1表示被在位置0处插入对象的起始位置(包括)，6是结束位置(不包括)
    sbuilder.insert(0, "0123456789", 1, 6);
    sbuilder.insert(0, '\n');

    // 在位置0处插入object对象。此处以hashmap为例
    hashmap map = new hashmap();
    map.put("1", "one");
    map.put("2", "two");
    map.put("3", "three");
    sbuilder.insert(0, map);

    system.out.printf("%s\n\n", sbuilder);
  }

  /**
   * stringbuilder 的append()示例
   */
  private static void testappendapis() {

    system.out.println("-------------------------------- testappendapis -------------------------------");

    stringbuilder sbuilder = new stringbuilder();

    // 追加字符数组
    sbuilder.append(new char[]{'a','b','c','d','e'});
    // 追加字符数组。0表示字符数组起始位置，3表示长度
    sbuilder.append(new char[]{'a','b','c','d','e'}, 0, 3);
    // 追加float
    sbuilder.append(1.414f);
    // 追加double
    sbuilder.append(3.14159d);
    // 追加boolean
    sbuilder.append(true);
    // 追加char
    sbuilder.append('\n');
    // 追加int
    sbuilder.append(100);
    // 追加long
    sbuilder.append(12345l);
    // 追加stringbuilder对象
    sbuilder.append(new stringbuilder("stringbuilder"));
    // 追加stringbuilder对象。6表示被追加对象的起始位置(包括)，13是结束位置(不包括)
    sbuilder.append(new stringbuilder("stringbuilder"), 6, 13);
    // 追加stringbuffer对象。
    sbuilder.append(new stringbuffer("stringbuffer"));
    // 追加stringbuffer对象。6表示被追加对象的起始位置(包括)，12是结束位置(不包括)
    sbuilder.append(new stringbuffer("stringbuffer"), 6, 12);
    // 追加string对象。
    sbuilder.append("string");
    // 追加string对象。1表示被追加对象的起始位置(包括)，6是结束位置(不包括)
    sbuilder.append("0123456789", 1, 6);
    sbuilder.append('\n');

    // 追加object对象。此处以hashmap为例
    hashmap map = new hashmap();
    map.put("1", "one");
    map.put("2", "two");
    map.put("3", "three");
    sbuilder.append(map);
    sbuilder.append('\n');

    // 追加unicode编码
    sbuilder.appendcodepoint(0x5b57);  // 0x5b57是“字”的unicode编码
    sbuilder.appendcodepoint(0x7b26);  // 0x7b26是“符”的unicode编码
    sbuilder.appendcodepoint(0x7f16);  // 0x7f16是“编”的unicode编码
    sbuilder.appendcodepoint(0x7801);  // 0x7801是“码”的unicode编码

    system.out.printf("%s\n\n", sbuilder);
  }
}