Stdlib/std.str/StringBuffer

StringBuffer

struct StringBuffer

StringBuffer is a mutable string.

In Navi string is immutable, so if you want to build a string, you can use StringBuffer.

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("Hello, ");
buf.push_string("World!");
assert_eq buf.to_string(), "Hello, World!";

Methods

pub fn to_string(self): string

pub fn bytes(self): Bytes

Return the bytes of StringBuffer.

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("hello world");
assert_eq buf.bytes(), "hello world".bytes();

pub fn truncate(self, length: int)

Truncate the StringBuffer to given length.

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("hello world");
assert_eq buf.len(), 11;

buf.truncate(5);
assert_eq buf.len(), 5;
assert_eq buf.to_string(), "hello";

pub fn reset(self)

Reset the buffer.

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("hello world");
assert_eq buf.len(), 11;

buf.reset();
assert_eq buf.len(), 0;

pub fn len(self): int

Return the bytes length of StringBuffer.

use std.str.StringBuffer;
let buf = StringBuffer.new();
buf.push_string("hello world");
assert_eq buf.len(), 11;

pub fn pop(self): char?

Pops the last char from the buffer.

Example

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("Hello");
assert_eq buf.pop(), 'o';
assert_eq buf.to_string(), "Hell";

pub fn push(self, c: char)

Appends a char to the buffer.

Example

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push('H');
buf.push('e');
buf.push('l');
buf.push('l');
buf.push('o');
assert_eq buf.to_string(), "Hello";

pub fn push_string(self, s: string)

Appends a string to the buffer.

Example

use std.str.StringBuffer;

let buf = StringBuffer.new();
buf.push_string("Hello, ");
buf.push_string("World!");
assert_eq buf.to_string(), "Hello, World!";

pub fn new(capacity: int = 0): StringBuffer

Creates a new StringBuffer.

Example

use std.str.StringBuffer;
let buf = StringBuffer.new();
assert_eq buf.to_string(), "";