Struct EncodingBuffer

pub struct EncodingBuffer { /* private fields */ }

EncodingBuffer for a Mail providing a buffer for encodable traits.

Implementations

impl EncodingBuffer

pub fn new(mail_type: MailType) -> Self

Create a new buffer only allowing input compatible with a the specified mail type.

pub fn mail_type(&self) -> MailType

Returns the mail type for which the buffer was created.

pub fn writer(&mut self) -> EncodingWriter<'_>

returns a new EncodingWriter which contains a mutable reference to the current string buffer

pub fn write_header_line<FN>(&mut self, func: FN) -> Result<(), EncodingError>

where FN: FnOnce(&mut EncodingWriter<'_>) -> Result<(), EncodingError>,

calls the provided function with a EncodingWriter cleaning up afterwards

After calling func with the EncodingWriter following cleanup is performed:

• if func returned an error handle.undo_header() is called, this won’t undo anything before a finish_header() call but will discard partial writes
• if func succeeded handle.finish_header() is called

pub fn write_blank_line(&mut self)

pub fn write_body_unchecked(&mut self, body: &impl AsRef<[u8]>)

writes a body to the internal buffer, without verifying it’s correctness

pub fn as_str(&self) -> Result<&str, EncodingError>

Error

This can fail if a body does not contain valid utf8.

pub fn to_string(&self) -> Result<String, EncodingError>

Converts the internal buffer into an utf-8 string if possible.

pub fn to_string_lossy(&self) -> Cow<'_, str>

Lossy conversion of the internal buffer to an string.

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

Return a slice view to the underlying buffer.

Trait Implementations

impl Into<(MailType, Vec<u8>)> for EncodingBuffer

fn into(self) -> (MailType, Vec<u8>)

Converts this type into the (usually inferred) input type.

impl Into<Vec<u8>> for EncodingBuffer

fn into(self) -> Vec<u8>

Converts this type into the (usually inferred) input type.