Crate writeable[−][src]
writeable
is a utility crate of the ICU4X
project.
It includes Writeable
, a core trait representing an object that can be written to a
sink implementing std::fmt::Write. It is an alternative to std::fmt::Display with the
addition of a function indicating the number of bytes to be written.
Writeable improves upon std::fmt::Display in two ways:
- More efficient, since the sink can pre-allocate bytes.
- Smaller code, since the format machinery can be short-circuited.
Types implementing Writeable have a defaulted writeable_to_string function. If desired, types implementing Writeable can manually implement ToString to wrap writeable_to_string.
Examples
use writeable::Writeable; use writeable::LengthHint; use writeable::assert_writeable_eq; use std::fmt; struct WelcomeMessage<'s>{ pub name: &'s str, } impl<'s> Writeable for WelcomeMessage<'s> { fn write_to<W: fmt::Write + ?Sized>(&self, sink: &mut W) -> fmt::Result { sink.write_str("Hello, ")?; sink.write_str(self.name)?; sink.write_char('!')?; Ok(()) } fn write_len(&self) -> LengthHint { // "Hello, " + '!' + length of name LengthHint::Exact(8 + self.name.len()) } } let message = WelcomeMessage { name: "Alice" }; assert_writeable_eq!("Hello, Alice!", &message);
Macros
assert_writeable_eq | Testing macro for types implementing Writeable. The first argument should be a string, and
the second argument should be a |
Enums
LengthHint | A hint to help consumers of Writeable pre-allocate bytes before they call write_to. |
Traits
Writeable | Writeable is an alternative to std::fmt::Display with the addition of a length function. |