StringBuffer 詳解 (String系列之3)

本文轉載自查看原文 2013-11-08 08:34 18282 Java/ StringBuffer/ 介紹/ API/ 詳解/ 詳細說明

本章介紹StringBuffer以及它的API的詳細使用方法。

轉載請注明出處：http://www.cnblogs.com/skywang12345/p/string03.html

StringBuffer 簡介

StringBuffer 是一個線程安全的可變的字符序列。它繼承於AbstractStringBuilder，實現了CharSequence接口。
StringBuilder 也是繼承於AbstractStringBuilder的子類；但是，StringBuilder和StringBuffer不同，前者是非線程安全的，后者是線程安全的。

StringBuffer 和 CharSequence之間的關系圖如下：

StringBuffer 函數列表

StringBuffer()
StringBuffer(int capacity)
StringBuffer(String string)
StringBuffer(CharSequence cs)

StringBuffer     append(boolean b)
StringBuffer     append(int i)
StringBuffer     append(long l)
StringBuffer     append(float f)
StringBuffer     append(double d)
synchronized StringBuffer     append(char ch)
synchronized StringBuffer     append(char[] chars)
synchronized StringBuffer     append(char[] chars, int start, int length)
synchronized StringBuffer     append(Object obj)
synchronized StringBuffer     append(String string)
synchronized StringBuffer     append(StringBuffer sb)
synchronized StringBuffer     append(CharSequence s)
synchronized StringBuffer     append(CharSequence s, int start, int end)
StringBuffer     appendCodePoint(int codePoint)
int     capacity()
synchronized char     charAt(int index)
synchronized int     codePointAt(int index)
synchronized int     codePointBefore(int index)
synchronized int     codePointCount(int beginIndex, int endIndex)
synchronized StringBuffer     delete(int start, int end)
synchronized StringBuffer     deleteCharAt(int location)
synchronized void     ensureCapacity(int min)
synchronized void     getChars(int start, int end, char[] buffer, int idx)
synchronized int     indexOf(String subString, int start)
int     indexOf(String string)
StringBuffer     insert(int index, boolean b)
StringBuffer     insert(int index, int i)
StringBuffer     insert(int index, long l)
StringBuffer     insert(int index, float f)
StringBuffer     insert(int index, double d)
synchronized StringBuffer     insert(int index, char ch)
synchronized StringBuffer     insert(int index, char[] chars)
synchronized StringBuffer     insert(int index, char[] chars, int start, int length)
synchronized StringBuffer     insert(int index, String string)
StringBuffer     insert(int index, Object obj)
synchronized StringBuffer     insert(int index, CharSequence s)
synchronized StringBuffer     insert(int index, CharSequence s, int start, int end)
int     lastIndexOf(String string)
synchronized int     lastIndexOf(String subString, int start)
int     length()
synchronized int     offsetByCodePoints(int index, int codePointOffset)
synchronized StringBuffer     replace(int start, int end, String string)
synchronized StringBuffer     reverse()
synchronized void     setCharAt(int index, char ch)
synchronized void     setLength(int length)
synchronized CharSequence     subSequence(int start, int end)
synchronized String     substring(int start)
synchronized String     substring(int start, int end)
synchronized String     toString()
synchronized void     trimToSize()

StringBuffer源碼(基於jdk1.7.40)

  1 package java.lang;
  2 
  3 public final class StringBuffer
  4     extends AbstractStringBuilder
  5     implements java.io.Serializable, CharSequence
  6 {
  7 
  8     static final long serialVersionUID = 3388685877147921107L;
  9 
 10     public StringBuffer() {
 11         super(16);
 12     }
 13 
 14     public StringBuffer(int capacity) {
 15         super(capacity);
 16     }
 17 
 18     public StringBuffer(String str) {
 19         super(str.length() + 16);
 20         append(str);
 21     }
 22 
 23     public StringBuffer(CharSequence seq) {
 24         this(seq.length() + 16);
 25         append(seq);
 26     }
 27 
 28     public synchronized int length() {
 29         return count;
 30     }
 31 
 32     public synchronized int capacity() {
 33         return value.length;
 34     }
 35 
 36 
 37     public synchronized void ensureCapacity(int minimumCapacity) {
 38         if (minimumCapacity > value.length) {
 39             expandCapacity(minimumCapacity);
 40         }
 41     }
 42 
 43     public synchronized void trimToSize() {
 44         super.trimToSize();
 45     }
 46 
 47     public synchronized void setLength(int newLength) {
 48         super.setLength(newLength);
 49     }
 50 
 51     public synchronized char charAt(int index) {
 52         if ((index < 0) || (index >= count))
 53             throw new StringIndexOutOfBoundsException(index);
 54         return value[index];
 55     }
 56 
 57     public synchronized int codePointAt(int index) {
 58         return super.codePointAt(index);
 59     }
 60 
 61     public synchronized int codePointBefore(int index) {
 62         return super.codePointBefore(index);
 63     }
 64 
 65     public synchronized int codePointCount(int beginIndex, int endIndex) {
 66         return super.codePointCount(beginIndex, endIndex);
 67     }
 68 
 69     public synchronized int offsetByCodePoints(int index, int codePointOffset) {
 70         return super.offsetByCodePoints(index, codePointOffset);
 71     }
 72 
 73     public synchronized void getChars(int srcBegin, int srcEnd, char[] dst,
 74                                       int dstBegin)
 75     {
 76         super.getChars(srcBegin, srcEnd, dst, dstBegin);
 77     }
 78 
 79     public synchronized void setCharAt(int index, char ch) {
 80         if ((index < 0) || (index >= count))
 81             throw new StringIndexOutOfBoundsException(index);
 82         value[index] = ch;
 83     }
 84 
 85     public synchronized StringBuffer append(Object obj) {
 86         super.append(String.valueOf(obj));
 87         return this;
 88     }
 89 
 90     public synchronized StringBuffer append(String str) {
 91         super.append(str);
 92         return this;
 93     }
 94 
 95     public synchronized StringBuffer append(StringBuffer sb) {
 96         super.append(sb);
 97         return this;
 98     }
 99 
100     public StringBuffer append(CharSequence s) {
101         // Note, synchronization achieved via other invocations
102         if (s == null)
103             s = "null";
104         if (s instanceof String)
105             return this.append((String)s);
106         if (s instanceof StringBuffer)
107             return this.append((StringBuffer)s);
108         return this.append(s, 0, s.length());
109     }
110 
111     public synchronized StringBuffer append(CharSequence s, int start, int end)
112     {
113         super.append(s, start, end);
114         return this;
115     }
116 
117     public synchronized StringBuffer append(char[] str) {
118         super.append(str);
119         return this;
120     }
121 
122     public synchronized StringBuffer append(char[] str, int offset, int len) {
123         super.append(str, offset, len);
124         return this;
125     }
126 
127     public synchronized StringBuffer append(boolean b) {
128         super.append(b);
129         return this;
130     }
131 
132     public synchronized StringBuffer append(char c) {
133         super.append(c);
134         return this;
135     }
136 
137     public synchronized StringBuffer append(int i) {
138         super.append(i);
139         return this;
140     }
141 
142     public synchronized StringBuffer appendCodePoint(int codePoint) {
143         super.appendCodePoint(codePoint);
144         return this;
145     }
146 
147     public synchronized StringBuffer append(long lng) {
148         super.append(lng);
149         return this;
150     }
151 
152     public synchronized StringBuffer append(float f) {
153         super.append(f);
154         return this;
155     }
156 
157     public synchronized StringBuffer append(double d) {
158         super.append(d);
159         return this;
160     }
161 
162     public synchronized StringBuffer delete(int start, int end) {
163         super.delete(start, end);
164         return this;
165     }
166 
167     public synchronized StringBuffer deleteCharAt(int index) {
168         super.deleteCharAt(index);
169         return this;
170     }
171 
172     public synchronized StringBuffer replace(int start, int end, String str) {
173         super.replace(start, end, str);
174         return this;
175     }
176 
177     public synchronized String substring(int start) {
178         return substring(start, count);
179     }
180 
181     public synchronized CharSequence subSequence(int start, int end) {
182         return super.substring(start, end);
183     }
184 
185     public synchronized String substring(int start, int end) {
186         return super.substring(start, end);
187     }
188 
189     public synchronized StringBuffer insert(int index, char[] str, int offset,
190                                             int len)
191     {
192         super.insert(index, str, offset, len);
193         return this;
194     }
195 
196     public synchronized StringBuffer insert(int offset, Object obj) {
197         super.insert(offset, String.valueOf(obj));
198         return this;
199     }
200 
201     public synchronized StringBuffer insert(int offset, String str) {
202         super.insert(offset, str);
203         return this;
204     }
205 
206     public synchronized StringBuffer insert(int offset, char[] str) {
207         super.insert(offset, str);
208         return this;
209     }
210 
211     public StringBuffer insert(int dstOffset, CharSequence s) {
212         // Note, synchronization achieved via other invocations
213         if (s == null)
214             s = "null";
215         if (s instanceof String)
216             return this.insert(dstOffset, (String)s);
217         return this.insert(dstOffset, s, 0, s.length());
218     }
219 
220     public synchronized StringBuffer insert(int dstOffset, CharSequence s,
221                                             int start, int end)
222     {
223         super.insert(dstOffset, s, start, end);
224         return this;
225     }
226 
227     public StringBuffer insert(int offset, boolean b) {
228         return insert(offset, String.valueOf(b));
229     }
230 
231     public synchronized StringBuffer insert(int offset, char c) {
232         super.insert(offset, c);
233         return this;
234     }
235 
236     public StringBuffer insert(int offset, int i) {
237         return insert(offset, String.valueOf(i));
238     }
239 
240     public StringBuffer insert(int offset, long l) {
241         return insert(offset, String.valueOf(l));
242     }
243 
244     public StringBuffer insert(int offset, float f) {
245         return insert(offset, String.valueOf(f));
246     }
247 
248     public StringBuffer insert(int offset, double d) {
249         return insert(offset, String.valueOf(d));
250     }
251 
252     public int indexOf(String str) {
253         return indexOf(str, 0);
254     }
255 
256     public synchronized int indexOf(String str, int fromIndex) {
257         return String.indexOf(value, 0, count,
258                               str.toCharArray(), 0, str.length(), fromIndex);
259     }
260 
261     public int lastIndexOf(String str) {
262         // Note, synchronization achieved via other invocations
263         return lastIndexOf(str, count);
264     }
265 
266     public synchronized int lastIndexOf(String str, int fromIndex) {
267         return String.lastIndexOf(value, 0, count,
268                               str.toCharArray(), 0, str.length(), fromIndex);
269     }
270 
271     public synchronized StringBuffer reverse() {
272         super.reverse();
273         return this;
274     }
275 
276     public synchronized String toString() {
277         return new String(value, 0, count);
278     }
279 
280     private static final java.io.ObjectStreamField[] serialPersistentFields =
281     {
282         new java.io.ObjectStreamField("value", char[].class),
283         new java.io.ObjectStreamField("count", Integer.TYPE),
284         new java.io.ObjectStreamField("shared", Boolean.TYPE),
285     };
286 
287     private synchronized void writeObject(java.io.ObjectOutputStream s)
288         throws java.io.IOException {
289         java.io.ObjectOutputStream.PutField fields = s.putFields();
290         fields.put("value", value);
291         fields.put("count", count);
292         fields.put("shared", false);
293         s.writeFields();
294     }
295 
296     private void readObject(java.io.ObjectInputStream s)
297         throws java.io.IOException, ClassNotFoundException {
298         java.io.ObjectInputStream.GetField fields = s.readFields();
299         value = (char[])fields.get("value", null);
300         count = fields.get("count", 0);
301     }
302 }

View Code

StringBuffer 示例

源碼如下(StringBufferTest.java):

  1 /**
  2  * StringBuffer 演示程序
  3  *
  4  * @author skywang
  5  */
  6 import java.util.HashMap;
  7 
  8 public class StringBufferTest {
  9 
 10     public static void main(String[] args) {
 11         testInsertAPIs() ;
 12         testAppendAPIs() ;
 13         testReplaceAPIs() ;
 14         testDeleteAPIs() ;
 15         testIndexAPIs() ;
 16         testOtherAPIs() ;
 17     }
 18 
 19     /**
 20      * StringBuffer 的其它API示例
 21      */
 22     private static void testOtherAPIs() {
 23 
 24         System.out.println("-------------------------------- testOtherAPIs --------------------------------");
 25 
 26         StringBuffer sbuilder = new StringBuffer("0123456789");
 27 
 28         int cap = sbuilder.capacity();
 29         System.out.printf("cap=%d\n", cap);
 30 
 31         char c = sbuilder.charAt(6);
 32         System.out.printf("c=%c\n", c);
 33 
 34         char[] carr = new char[4];
 35         sbuilder.getChars(3, 7, carr, 0);
 36         for (int i=0; i<carr.length; i++)
 37             System.out.printf("carr[%d]=%c ", i, carr[i]);
 38         System.out.println();
 39 
 40         System.out.println();
 41     }
 42 
 43     /**
 44      * StringBuffer 中index相關API演示
 45      */
 46     private static void testIndexAPIs() {
 47         System.out.println("-------------------------------- testIndexAPIs --------------------------------");
 48 
 49         StringBuffer sbuilder = new StringBuffer("abcAbcABCabCaBcAbCaBCabc");
 50         System.out.printf("sbuilder=%s\n", sbuilder);
 51 
 52         // 1. 從前往后，找出"bc"第一次出現的位置
 53         System.out.printf("%-30s = %d\n", "sbuilder.indexOf(\"bc\")", sbuilder.indexOf("bc"));
 54 
 55         // 2. 從位置5開始，從前往后，找出"bc"第一次出現的位置
 56         System.out.printf("%-30s = %d\n", "sbuilder.indexOf(\"bc\", 5)", sbuilder.indexOf("bc", 5));
 57 
 58         // 3. 從后往前，找出"bc"第一次出現的位置
 59         System.out.printf("%-30s = %d\n", "sbuilder.lastIndexOf(\"bc\")", sbuilder.lastIndexOf("bc"));
 60 
 61         // 4. 從位置4開始，從后往前，找出"bc"第一次出現的位置
 62         System.out.printf("%-30s = %d\n", "sbuilder.lastIndexOf(\"bc\", 4)", sbuilder.lastIndexOf("bc", 4));
 63 
 64         System.out.println();
 65     }
 66 
 67     /**
 68      * StringBuffer 的replace()示例
 69      */
 70     private static void testReplaceAPIs() {
 71 
 72         System.out.println("-------------------------------- testReplaceAPIs ------------------------------");
 73 
 74         StringBuffer sbuilder;
 75 
 76         sbuilder = new StringBuffer("0123456789");
 77         sbuilder.replace(0, 3, "ABCDE");
 78         System.out.printf("sbuilder=%s\n", sbuilder);
 79 
 80         sbuilder = new StringBuffer("0123456789");
 81         sbuilder.reverse();
 82         System.out.printf("sbuilder=%s\n", sbuilder);
 83 
 84         sbuilder = new StringBuffer("0123456789");
 85         sbuilder.setCharAt(0, 'M');
 86         System.out.printf("sbuilder=%s\n", sbuilder);
 87 
 88         System.out.println();
 89     }
 90 
 91     /**
 92      * StringBuffer 的delete()示例
 93      */
 94     private static void testDeleteAPIs() {
 95 
 96         System.out.println("-------------------------------- testDeleteAPIs -------------------------------");
 97 
 98         StringBuffer sbuilder = new StringBuffer("0123456789");
 99         
100         // 刪除位置0的字符，剩余字符是“123456789”。
101         sbuilder.deleteCharAt(0);
102         // 刪除位置3(包括)到位置6(不包括)之間的字符，剩余字符是“123789”。
103         sbuilder.delete(3,6);
104 
105         // 獲取sb中從位置1開始的字符串
106         String str1 = sbuilder.substring(1);
107         // 獲取sb中從位置3(包括)到位置5(不包括)之間的字符串
108         String str2 = sbuilder.substring(3, 5);
109         // 獲取sb中從位置3(包括)到位置5(不包括)之間的字符串，獲取的對象是CharSequence對象，此處轉型為String
110         String str3 = (String)sbuilder.subSequence(3, 5);
111 
112         System.out.printf("sbuilder=%s\nstr1=%s\nstr2=%s\nstr3=%s\n", 
113                 sbuilder, str1, str2, str3);
114 
115         System.out.println();
116     }
117 
118     /**
119      * StringBuffer 的insert()示例
120      */
121     private static void testInsertAPIs() {
122 
123         System.out.println("-------------------------------- testInsertAPIs -------------------------------");
124 
125         StringBuffer sbuilder = new StringBuffer();
126 
127         // 在位置0處插入字符數組
128         sbuilder.insert(0, new char[]{'a','b','c','d','e'});
129         // 在位置0處插入字符數組。0表示字符數組起始位置，3表示長度
130         sbuilder.insert(0, new char[]{'A','B','C','D','E'}, 0, 3);
131         // 在位置0處插入float
132         sbuilder.insert(0, 1.414f);
133         // 在位置0處插入double
134         sbuilder.insert(0, 3.14159d);
135         // 在位置0處插入boolean
136         sbuilder.insert(0, true);
137         // 在位置0處插入char
138         sbuilder.insert(0, '\n');
139         // 在位置0處插入int
140         sbuilder.insert(0, 100);
141         // 在位置0處插入long
142         sbuilder.insert(0, 12345L);
143         // 在位置0處插入StringBuilder對象
144         sbuilder.insert(0, new StringBuffer("StringBuilder"));
145         // 在位置0處插入StringBuilder對象。6表示被在位置0處插入對象的起始位置(包括)，13是結束位置(不包括)
146         sbuilder.insert(0, new StringBuffer("STRINGBUILDER"), 6, 13);
147         // 在位置0處插入StringBuffer對象。
148         sbuilder.insert(0, new StringBuffer("StringBuffer"));
149         // 在位置0處插入StringBuffer對象。6表示被在位置0處插入對象的起始位置(包括)，12是結束位置(不包括)
150         sbuilder.insert(0, new StringBuffer("STRINGBUFFER"), 6, 12);
151         // 在位置0處插入String對象。
152         sbuilder.insert(0, "String");
153         // 在位置0處插入String對象。1表示被在位置0處插入對象的起始位置(包括)，6是結束位置(不包括)
154         sbuilder.insert(0, "0123456789", 1, 6);
155         sbuilder.insert(0, '\n');
156 
157         // 在位置0處插入Object對象。此處以HashMap為例
158         HashMap map = new HashMap();
159         map.put("1", "one");
160         map.put("2", "two");
161         map.put("3", "three");
162         sbuilder.insert(0, map);
163 
164         System.out.printf("%s\n\n", sbuilder);
165     }
166 
167     /**
168      * StringBuffer 的append()示例
169      */
170     private static void testAppendAPIs() {
171 
172         System.out.println("-------------------------------- testAppendAPIs -------------------------------");
173 
174         StringBuffer sbuilder = new StringBuffer();
175 
176         // 追加字符數組
177         sbuilder.append(new char[]{'a','b','c','d','e'});
178         // 追加字符數組。0表示字符數組起始位置，3表示長度
179         sbuilder.append(new char[]{'A','B','C','D','E'}, 0, 3);
180         // 追加float
181         sbuilder.append(1.414f);
182         // 追加double
183         sbuilder.append(3.14159d);
184         // 追加boolean
185         sbuilder.append(true);
186         // 追加char
187         sbuilder.append('\n');
188         // 追加int
189         sbuilder.append(100);
190         // 追加long
191         sbuilder.append(12345L);
192         // 追加StringBuilder對象
193         sbuilder.append(new StringBuffer("StringBuilder"));
194         // 追加StringBuilder對象。6表示被追加對象的起始位置(包括)，13是結束位置(不包括)
195         sbuilder.append(new StringBuffer("STRINGBUILDER"), 6, 13);
196         // 追加StringBuffer對象。
197         sbuilder.append(new StringBuffer("StringBuffer"));
198         // 追加StringBuffer對象。6表示被追加對象的起始位置(包括)，12是結束位置(不包括)
199         sbuilder.append(new StringBuffer("STRINGBUFFER"), 6, 12);
200         // 追加String對象。
201         sbuilder.append("String");
202         // 追加String對象。1表示被追加對象的起始位置(包括)，6是結束位置(不包括)
203         sbuilder.append("0123456789", 1, 6);
204         sbuilder.append('\n');
205 
206         // 追加Object對象。此處以HashMap為例
207         HashMap map = new HashMap();
208         map.put("1", "one");
209         map.put("2", "two");
210         map.put("3", "three");
211         sbuilder.append(map);
212         sbuilder.append('\n');
213 
214         // 追加unicode編碼
215         sbuilder.appendCodePoint(0x5b57);    // 0x5b57是“字”的unicode編碼
216         sbuilder.appendCodePoint(0x7b26);    // 0x7b26是“符”的unicode編碼
217         sbuilder.appendCodePoint(0x7f16);    // 0x7f16是“編”的unicode編碼
218         sbuilder.appendCodePoint(0x7801);    // 0x7801是“碼”的unicode編碼
219 
220         System.out.printf("%s\n\n", sbuilder);
221     }
222 }

運行結果：

-------------------------------- testInsertAPIs -------------------------------
{3=three, 2=two, 1=one}
12345StringBUFFERStringBufferBUILDERStringBuilder12345100
true3.141591.414ABCabcde

-------------------------------- testAppendAPIs -------------------------------
abcdeABC1.4143.14159true
10012345StringBuilderBUILDERStringBufferBUFFERString12345
{3=three, 2=two, 1=one}
字符編碼

-------------------------------- testReplaceAPIs ------------------------------
sbuilder=ABCDE3456789
sbuilder=9876543210
sbuilder=M123456789

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

-------------------------------- testIndexAPIs --------------------------------
sbuilder=abcAbcABCabCaBcAbCaBCabc
sbuilder.indexOf("bc")         = 1
sbuilder.indexOf("bc", 5)      = 22
sbuilder.lastIndexOf("bc")     = 22
sbuilder.lastIndexOf("bc", 4)  = 4

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

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 String詳解, String和CharSequence區別, StringBuilder和StringBuffer的區別 (String系列之1) StringBuilder 詳解 (String系列之2) String 與 StringBuffer的區別 String和StringBuffer的區別 String與StringBuffer之間的轉換 string和stringBuffer，stringBuilder的區別 String與StringBuffer區別 1 String、StringBuffer與StringBuilder區別 String與StringBuffer效率對比 String和StringBuffer的區別