OLD | NEW |
1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 part of dart.core; | 5 part of dart.core; |
6 | 6 |
7 /** | 7 /** |
8 * The StringBuffer class is useful for concatenating strings | 8 * The StringBuffer class is useful for concatenating strings |
9 * efficiently. Only on a call to [toString] are the strings | 9 * efficiently. Only on a call to [toString] are the strings |
10 * concatenated to a single String. | 10 * concatenated to a single String. |
11 */ | 11 */ |
12 abstract class StringBuffer { | 12 class StringBuffer implements StringSink { |
13 | 13 |
14 /// Creates the string buffer with an initial content. | 14 /// Creates the string buffer with an initial content. |
15 external factory StringBuffer([Object content = ""]); | 15 external StringBuffer([Object content = ""]); |
16 | 16 |
17 /// Returns the length of the buffer. | 17 /// Returns the length of the buffer. |
18 int get length; | 18 external int get length; |
19 | 19 |
20 // Returns whether the buffer is empty. | 20 /// Returns whether the buffer is empty. |
21 bool get isEmpty; | 21 bool get isEmpty => length == 0; |
22 | 22 |
23 /// Converts [obj] to a string and adds it to the buffer. | 23 /** |
24 void add(Object obj); | 24 * Converts [obj] to a string and adds it to the buffer. |
| 25 * |
| 26 * *Deprecated*. Use [write] instead. |
| 27 */ |
| 28 @deprecated |
| 29 void add(Object obj) => write(obj); |
| 30 |
| 31 external void write(Object obj); |
| 32 |
| 33 void writeAll(Iterable objects) { |
| 34 for (Object obj in objects) write(obj); |
| 35 } |
| 36 |
| 37 void writeln(Object obj) { |
| 38 write(obj); |
| 39 write("\n"); |
| 40 } |
| 41 |
| 42 /** |
| 43 * Adds the string representation of [charCode] to the buffer. |
| 44 * |
| 45 * *Deprecated* Use [writeCharCode] instead. |
| 46 */ |
| 47 @deprecated |
| 48 void addCharCode(int charCode) { |
| 49 writeCharCode(charCode); |
| 50 } |
25 | 51 |
26 /// Adds the string representation of [charCode] to the buffer. | 52 /// Adds the string representation of [charCode] to the buffer. |
27 void addCharCode(int charCode); | 53 void writeCharCode(int charCode) { |
| 54 write(new String.fromCharCode(charCode)); |
| 55 } |
28 | 56 |
29 /// Adds all items in [objects] to the buffer. | 57 /** |
30 void addAll(Iterable objects); | 58 * Adds all items in [objects] to the buffer. |
| 59 * |
| 60 * *Deprecated*. Use [writeAll] instead. |
| 61 */ |
| 62 @deprecated |
| 63 void addAll(Iterable objects) { |
| 64 for (Object obj in objects) write(obj); |
| 65 } |
31 | 66 |
32 /// Clears the string buffer. | 67 /** |
33 void clear(); | 68 * Clears the string buffer. |
| 69 * |
| 70 * *Deprecated*. |
| 71 */ |
| 72 @deprecated |
| 73 external void clear(); |
34 | 74 |
35 /// Returns the contents of buffer as a concatenated string. | 75 /// Returns the contents of buffer as a concatenated string. |
36 String toString(); | 76 external String toString(); |
37 } | 77 } |
OLD | NEW |