Enum ContentType

pub enum ContentType<'msg> {
    StringSlice(&'msg str),
    NonUtf8ByteSlice(&'msg [u8]),
}

A wrapper containing either a string slice or a non-utf8 slice of bytes.

Motivation

It is possible for an IrcMsg to contain non-utf8 bytes and still be valid. I wanted to provide the option to create such messages to allow the user of this library to decide what they want to do with the content.

Limitations

I cannot use from_utf8_lossy in a #![no_std] and const context to display the contents of a non-utf8 slice of bytes with replacement characters in this library. The user of this library is not under the same restriction. The Display impl thus prints the array of bytes the same way as deriving Debug does.

Variants

StringSlice(&'msg str)

A utf8 string slice.

NonUtf8ByteSlice(&'msg [u8])

A non-utf8 slice of bytes.

Implementations

impl<'msg> ContentType<'msg>

pub const fn is_valid_utf8(&self) -> bool

Checks if inner contents are valid utf8.

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

Returns the inner contents as an array of bytes.

Trait Implementations

impl<'msg> Clone for ContentType<'msg>

fn clone(&self) -> ContentType<'msg>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'msg> Debug for ContentType<'msg>

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

Formats the value using the given formatter.

impl<'msg> Display for ContentType<'msg>

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

Formats the value using the given formatter.

impl<'msg> PartialEq for ContentType<'msg>

fn eq(&self, other: &ContentType<'msg>) -> 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<'msg> Copy for ContentType<'msg>

impl<'msg> Eq for ContentType<'msg>

impl<'msg> StructuralPartialEq for ContentType<'msg>