Struct Writer 

pub struct Writer { /* private fields */ }

Accumulates rendered text with an indentation level.

Implementations

impl Writer

pub fn new(unit: &'static str) -> Self

A writer indenting by unit per level.

pub fn spaces4() -> Self

A writer indenting by four spaces, which is what Rust, C++ and Java conventionally use and what the previous emitters wrote.

pub fn indent(&mut self)

Go one level deeper.

pub fn dedent(&mut self)

Come back one level.

pub const fn depth(&self) -> usize

How deep it currently is, so a caller can assert on balance.

pub fn push(&mut self, text: &str)

Write text, indenting first when the line is still empty.

pub fn line(&mut self, text: &str)

Write text and end the line.

pub fn newline(&mut self)

End the line.

A line with nothing on it gets no indentation: trailing whitespace on a blank line is what a formatter strips and what a byte-comparison then reports as a difference.

pub fn finish_line(&mut self)

End the line only if something has been written to it.

For a renderer that does not know whether the previous node left the line open.

pub fn blank_line(&mut self)

An empty line, unless the output is empty or already ends in one.

Idempotent so that a renderer separating two optional sections does not have to know whether the first was there.

pub fn is_empty(&self) -> bool

Whether nothing has been written.

pub fn as_str(&self) -> &str

The text written so far.

pub fn finish(self) -> String

The text, with the writer consumed.

Trait Implementations

impl Clone for Writer

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Writer

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

Formats the value using the given formatter.

impl Default for Writer

fn default() -> Self

Returns the “default value” for a type.