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); }}

運行結果：

 23erawtfos 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}12345StringBUFFERStringBufferBUILDERStringBuilder12345100true3.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.14159true10012345StringBuilderBUILDERStringBufferBUFFERString12345{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=ABCDE3456789sbuilder=9876543210sbuilder=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=123789str1=23789str2=78str3=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=abcAbcABCabCaBcAbCaBCabcsbuilder.indexOf("bc") = 1sbuilder.indexOf("bc", 5) = 22sbuilder.lastIndexOf("bc") = 22sbuilder.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=26c=6carr[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); }}