Struct ascii::FromAsciiError

pub struct FromAsciiError<O> { /* fields omitted */ }

A possible error value when converting an AsciiString from a byte vector or string. It wraps an AsAsciiStrError which you can get through the ascii_error() method.

This is the error type for AsciiString::from_ascii() and IntoAsciiString::into_ascii_string(). They will never clone or touch the content of the original type; It can be extracted by the into_source method.

#Examples

let err = "bø!".to_string().into_ascii_string().unwrap_err();
assert_eq!(err.ascii_error().valid_up_to(), 1);
assert_eq!(err.into_source(), "bø!".to_string());

Methods

impl<O> FromAsciiError<O>

pub fn ascii_error(&self) -> AsAsciiStrError

Get the position of the first non-ASCII byte or character.

pub fn into_source(self) -> O

Get back the original, unmodified type.

Trait Implementations

impl<O: PartialEq> PartialEq<FromAsciiError<O>> for FromAsciiError<O>

fn eq(&self, other: &FromAsciiError<O>) -> bool

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

fn ne(&self, other: &FromAsciiError<O>) -> bool

This method tests for !=.

impl<O: Clone> Clone for FromAsciiError<O>

fn clone(&self) -> FromAsciiError<O>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<O: Eq> Eq for FromAsciiError<O>

impl<O: Copy> Copy for FromAsciiError<O>

impl<O> Debug for FromAsciiError<O>

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

Formats the value using the given formatter.

impl<O> Display for FromAsciiError<O>

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

Formats the value using the given formatter.

impl<O: Any> Error for FromAsciiError<O>

fn description(&self) -> &str

This method is soft-deprecated.

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Always returns an AsAsciiStrError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.