Spaces:
Sleeping
Sleeping
File size: 1,397 Bytes
31248b9 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
// See LICENSE in the project root for license information.
/**
* This class allows a large text string to be constructed incrementally by appending small chunks. The final
* string can be obtained by calling StringBuilder.toString().
*
* @remarks
* A naive approach might use the `+=` operator to append strings: This would have the downside of copying
* the entire string each time a chunk is appended, resulting in `O(n^2)` bytes of memory being allocated
* (and later freed by the garbage collector), and many of the allocations could be very large objects.
* StringBuilder avoids this overhead by accumulating the chunks in an array, and efficiently joining them
* when `getText()` is finally called.
*/
export class StringBuilder {
constructor() {
this._chunks = [];
}
/** {@inheritdoc IStringBuilder.append} */
append(text) {
this._chunks.push(text);
}
/** {@inheritdoc IStringBuilder.toString} */
toString() {
if (this._chunks.length === 0) {
return '';
}
if (this._chunks.length > 1) {
const joined = this._chunks.join('');
this._chunks.length = 1;
this._chunks[0] = joined;
}
return this._chunks[0];
}
}
//# sourceMappingURL=StringBuilder.js.map |