Enum mail_headers::data::InnerAscii

pub enum InnerAscii {
    Owned(SoftAsciiString),
    Shared(OwningRef<Arc<String>, SoftAsciiStr>),
}

InnerAscii is string data container which can contain either a owned SoftAsciiString or a SoftAsciiStr reference into a shared string buffer.

Variants

Owned(SoftAsciiString)Shared(OwningRef<Arc<String>, SoftAsciiStr>)

Methods

impl InnerAscii

pub fn into_shared(self) -> Self

converts this container into on which uses underlying shared data

if the data is already shared nothing is done. If not the owned data is converted into the underlying string buffer and OwningRef is used to enable the shared reference

Note that the underlying buffer is no an SoftAsciiString but a String (from which we happend to know that it fulfills the "is us-ascii" soft constraint). This allows us to have an InnerAscii share data with a possible non us-ascii string buffer as long as the part accessable through the SoftAsciiStr is ascii. Or at last should be ascii as it's a soft constraint.

impl InnerAscii

pub fn new<S: Into<SoftAsciiString>>(data: S) -> Self

impl InnerAscii

pub fn as_str(&self) -> &str

Methods from Deref<Target = SoftAsciiStr>

pub fn revalidate_soft_constraint(
    &self
) -> Result<&SoftAsciiStr, FromSourceError<&str>>

reruns checks if the "is us-ascii" soft constraint is still valid

pub fn as_str(&self) -> &str

pub fn lines(&self) -> SoftAsciiLines

pub fn split_whitespace(&self) -> SoftAsciiSplitWhitespace

pub fn char_indices(&self) -> SoftAsciiCharIndices

pub fn chars(&self) -> SoftAsciiChars

pub fn split_at(&self, mid: usize) -> (&SoftAsciiStr, &SoftAsciiStr)

pub unsafe fn slice_unchecked(&self, begin: usize, end: usize) -> &SoftAsciiStr

pub fn parse<F>(&self) -> Result<F, <F as FromStr>::Err> where
    F: FromStr, 

pub fn to_lowercase(&self) -> SoftAsciiString

pub fn to_uppercase(&self) -> SoftAsciiString

pub fn repeat(&self, n: usize) -> SoftAsciiString

pub fn trim_right(&self) -> &SoftAsciiStr

pub fn trim_left(&self) -> &SoftAsciiStr

pub fn trim(&self) -> &SoftAsciiStr

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn is_char_boundary(&self, index: usize) -> bool

pub fn as_ptr(&self) -> *const u8

pub fn encode_utf16(&self) -> EncodeUtf16

pub fn is_ascii(&self) -> bool

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

Trait Implementations

impl From<SoftAsciiString> for InnerAscii

fn from(data: SoftAsciiString) -> Self

Performs the conversion.

impl Eq for InnerAscii

impl Into<SoftAsciiString> for InnerAscii

fn into(self) -> SoftAsciiString

Performs the conversion.

impl AsRef<str> for InnerAscii

fn as_ref(&self) -> &str

Performs the conversion.

impl PartialEq<InnerAscii> for InnerAscii

fn eq(&self, other: &InnerAscii) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

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

This method tests for !=.

impl Clone for InnerAscii

fn clone(&self) -> InnerAscii

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InnerAscii

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

Formats the value using the given formatter.

impl Hash for InnerAscii

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Deref for InnerAscii

type Target = SoftAsciiStr

The resulting type after dereferencing.

fn deref(&self) -> &SoftAsciiStr

Dereferences the value.

impl Serialize for InnerAscii

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for InnerAscii

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.