Trait Printer

Source

pub trait Printer: Sized {
    type Token;

Show 24 methods    // Required methods
    fn buf(&self) -> &str;
    fn buf_mut(&mut self) -> &mut String;
    fn indent_level(&self) -> usize;
    fn set_indent(&mut self, level: usize);
    fn into_string(self) -> String;
    fn token(&mut self, t: &Self::Token);

    // Provided methods
    fn word(&mut self, s: &str) { ... }
    fn char(&mut self, c: char) { ... }
    fn space(&mut self) { ... }
    fn spaces(&mut self, n: usize) { ... }
    fn tab(&mut self) { ... }
    fn tabs(&mut self, n: usize) { ... }
    fn newline(&mut self) { ... }
    fn add_indent(&mut self) { ... }
    fn indent_width(&self) -> usize { ... }
    fn spaces_width(&self) -> usize { ... }
    fn use_tabs(&self) -> bool { ... }
    fn indent(&mut self) { ... }
    fn dedent(&mut self) { ... }
    fn open_block(&mut self, open: &Self::Token) { ... }
    fn close_block(&mut self, close: &Self::Token) { ... }
    fn write<T>(&mut self, value: &T)
       where T: ToTokens<Printer = Self> { ... }
    fn write_separated<T, I>(
        &mut self,
        items: I,
        sep: &Self::Token,
        trailing: bool,
        newline_after_sep: bool,
    )
       where T: ToTokens<Printer = Self>,
             I: IntoIterator<Item = T>,
             <I as IntoIterator>::IntoIter: ExactSizeIterator { ... }
    fn write_separated_inline<T, I>(&mut self, items: I, sep: &Self::Token)
       where T: ToTokens<Printer = Self>,
             I: IntoIterator<Item = T>,
             <I as IntoIterator>::IntoIter: ExactSizeIterator { ... }
}

Expand description

Trait for building formatted text output.

Printer provides a structured way to generate formatted text with support for indentation, whitespace control, and token formatting. It’s used by ToTokens implementations to produce output.

§Associated Types

Token: The token type for grammar-specific formatting

§Required Methods

buf(): Get current buffer contents
buf_mut(): Get mutable buffer for appending
indent_level(): Current indentation depth
set_indent(level): Set indentation depth
into_string(): Consume and return final output
token(t): Format a token (grammar-specific)

§Provided Methods

Basic output:

word(s), char(c): Append text
space(), spaces(n), tab(), tabs(n): Whitespace
newline(): Newline with auto-indent

Indentation:

indent(), dedent(): Change indent level
open_block(token), close_block(token): Block delimiters

Structured output:

write(value): Write a ToTokens value
write_separated(items, sep, ...): Write items with separators

§Example

use synkit::Printer;

#[derive(Default)]
struct MyPrinter {
    buf: String,
    indent: usize,
}

impl Printer for MyPrinter {
    type Token = MyTok;

    fn buf(&self) -> &str { &self.buf }
    fn buf_mut(&mut self) -> &mut String { &mut self.buf }
    fn indent_level(&self) -> usize { self.indent }
    fn set_indent(&mut self, level: usize) { self.indent = level; }
    fn into_string(self) -> String { self.buf }

    fn token(&mut self, t: &Self::Token) {
        match t {
            MyTok::Plus => self.word("+"),
            MyTok::Minus => self.word("-"),
            // ...
        }
    }
}