Struct Body

pub struct Body { /* private fields */ }

A Message or SinglePart body that has already been encoded.

Implementations

impl Body

pub fn new<B: Into<MaybeString>>(buf: B) -> Self

Encode the supplied buf, making it ready to be sent as a body.

Takes a Vec<u8> or a String.

Automatically chooses the most efficient encoding between 7bit, quoted-printable and base64.

If String is passed, line endings are converted to CRLF.

If buf is valid utf-8 a String should be supplied, as Strings can be encoded as 7bit or quoted-printable, while Vec<u8> always get encoded as base64.

pub fn new_with_encoding<B: Into<MaybeString>>( buf: B, encoding: ContentTransferEncoding, ) -> Result<Self, Vec<u8>>

Encode the supplied buf, using the provided encoding.

Body::new is generally the better option.

If String is passed, line endings are converted to CRLF.

Returns an Err giving back the supplied buf, in case the chosen encoding would have resulted into buf being encoded into an invalid body.

pub fn dangerous_pre_encoded( buf: Vec<u8>, encoding: ContentTransferEncoding, ) -> Self

Builds a new Body using a pre-encoded buffer.

Generally not you want.

buf shouldn’t contain non-ascii characters, lines longer than 1000 characters or nul bytes.

pub fn len(&self) -> usize

Returns the length of this Body in bytes.

pub fn is_empty(&self) -> bool

Returns true if this Body has a length of zero, false otherwise.

pub fn encoding(&self) -> ContentTransferEncoding

Returns the Content-Transfer-Encoding of this Body.

pub fn into_vec(self) -> Vec<u8>

Consumes Body and returns the inner Vec<u8>

Trait Implementations

impl AsRef<[u8]> for Body

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Body

fn clone(&self) -> Body

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Body

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

Formats the value using the given formatter.

impl IntoBody for Body

fn into_body(self, encoding: Option<ContentTransferEncoding>) -> Body

Encode as valid body