Struct FmtWriter

pub struct FmtWriter<F1>(/* private fields */);

A writer that calls write_str for each formatted chunk, but do not require allocations.

Write function can return either () or for<E> Result<(), E>.

Panics

Writer panics if the write function returns Result::Err.

Implementations

impl<F1> FmtWriter<F1>

where F1: WriteStr,

pub fn new(write: F1) -> Self

Creates a new FmtWriter from an object that implements WriteStr.

pub fn from_closure<F, Ts>(closure: F) -> Self

where F: IntoWriteFn<Ts, WriteFn = F1>,

Creates a new FmtWriter with a WriteStr wrapper deduced with IntoWriteFn by the closure signature and constructed from it.

impl<F1> FmtWriter<F1>

where Self: Write,

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

Writes a formatted string into this writer.

This method is primarily used to interface with the format_args! macro, but it is rare that this should explicitly be called. The write! macro should be favored to invoke this method instead.

Trait Implementations

impl<F1: Clone> Clone for FmtWriter<F1>

fn clone(&self) -> FmtWriter<F1>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F1: Debug> Debug for FmtWriter<F1>

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

Formats the value using the given formatter.

impl<F1: PartialEq> PartialEq for FmtWriter<F1>

fn eq(&self, other: &FmtWriter<F1>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<F1> Write for FmtWriter<F1>

where Self: WriteStr<Output = Result>,

fn write_str(&mut self, buf: &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.

impl<F1> WriteBytes for FmtWriter<F1>

where F1: WriteBytes, F1::Output: ExpectFmtWriteResult,

type Output = Result<(), Error>

The resulting type after writing.

fn write_bytes(&mut self, buf: &[u8]) -> Self::Output

Performs byte writing.

impl<F1> WriteStr for FmtWriter<F1>

where F1: WriteStr, F1::Output: ExpectFmtWriteResult,

type Output = Result<(), Error>

The resulting type after writing.

fn write_str(&mut self, buf: &str) -> Self::Output

Performs byte writing.

impl<F1: Copy> Copy for FmtWriter<F1>

impl<F1: Eq> Eq for FmtWriter<F1>

impl<F1> StructuralPartialEq for FmtWriter<F1>