Struct Buf 

pub struct Buf<'a> { /* private fields */ }

A fixed-capacity buffer over caller-owned bytes: the allocator-free way to format a value.

use tzcraft::write::Buf;
use tzcraft::write::Write;

let mut storage = [0u8; 64];
let mut buf = Buf::new(&mut storage);
buf.write_str("hello")?;
assert_eq!(buf.as_str(), "hello");

Implementations

impl<'a> Buf<'a>

pub fn new(data: &'a mut [u8]) -> Buf<'a>

Wrap data as an empty sink; content is appended from offset 0.

pub const fn len(&self) -> usize

Number of bytes written so far.

pub const fn is_empty(&self) -> bool

Whether nothing has been written yet.

pub const fn capacity(&self) -> usize

Total capacity of the backing slice.

pub fn as_bytes(&self) -> &[u8]

The written bytes.

pub fn as_str(&self) -> &str

The written bytes as a &str.

This never fails: every byte written through Write is valid UTF-8 by construction (the formatter only emits ASCII digits, ASCII punctuation and literal UTF-8 text from format strings).

pub fn clear(&mut self)

Reset to empty, reusing the backing slice.

Trait Implementations

impl<'a> Debug for Buf<'a>

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

Formats the value using the given formatter.

impl Write for Buf<'_>

fn write_bytes(&mut self, bytes: &[u8]) -> Result<()>

Append a UTF-8 byte slice. Implementations used as text sinks return an error for invalid UTF-8.

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

Append a &str (its UTF-8 encoding is written verbatim).

fn write_byte(&mut self, b: u8) -> Result<()>

Append one byte.

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

Append one character, UTF-8 encoded.