Struct StringBuilder 

pub struct StringBuilder { /* private fields */ }

A mutable string builder with convenient push methods.

Accumulates string fragments and can be finalised into a String. Supports indentation tracking for pretty-printing.

Implementations

impl StringBuilder

pub fn new() -> Self

Create a new empty StringBuilder.

pub fn with_capacity(cap: usize) -> Self

Create a StringBuilder with pre-allocated capacity.

pub fn set_indent_width(&mut self, w: usize) -> &mut Self

Set the number of spaces per indent level (default: 2).

pub fn push_str(&mut self, s: &str) -> &mut Self

Append a string slice.

pub fn push(&mut self, c: char) -> &mut Self

Append a single character.

pub fn newline(&mut self) -> &mut Self

Append a newline followed by the current indentation.

pub fn line(&mut self, s: &str) -> &mut Self

Append s followed by a newline (and indent for next line).

pub fn indent(&mut self) -> &mut Self

Increase the indentation level by 1.

pub fn dedent(&mut self) -> &mut Self

Decrease the indentation level by 1 (minimum 0).

pub fn push_fmt(&mut self, args: Arguments<'_>) -> &mut Self

Append s formatted with format!.

pub fn len(&self) -> usize

Current byte length of the buffer.

pub fn is_empty(&self) -> bool

Returns true if the buffer is empty.

pub fn finish(self) -> String

Finalise and return the accumulated string.

pub fn as_str(&self) -> &str

Get a reference to the accumulated string so far.

pub fn clear(&mut self)

Clear the buffer, keeping capacity.

pub fn sep(&mut self, s: &str) -> &mut Self

Append a separator only if the buffer is non-empty.

Trait Implementations

impl Clone for StringBuilder

fn clone(&self) -> StringBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StringBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StringBuilder

fn default() -> StringBuilder

Returns the “default value” for a type.

impl From<StringBuilder> for String

fn from(sb: StringBuilder) -> String

Converts to this type from the input type.

impl Write for StringBuilder

fn write_str(&mut self, s: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a char into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the write! macro with implementors of this trait.