Enum asn1_rs::Err

pub enum Err<E> {
    Incomplete(Needed),
    Error(E),
    Failure(E),
}

The Err enum indicates the parser was not successful

It has three cases:

• Incomplete indicates that more data is needed to decide. The Needed enum can contain how many additional bytes are necessary. If you are sure your parser is working on full data, you can wrap your parser with the complete combinator to transform that case in Error
• Error means some parser did not succeed, but another one might (as an example, when testing different branches of an alt combinator)
• Failure indicates an unrecoverable error. As an example, if you recognize a prefix to decide on the next parser to apply, and that parser fails, you know there’s no need to try other parsers, you were already in the right branch, so the data is invalid

Variants

Incomplete(Needed)

There was not enough data

Error(E)

The parser had an error (recoverable)

Failure(E)

The parser had an unrecoverable error: we got to the right branch and we know other branches won’t work, so backtrack as fast as possible

Implementations

impl<E> Err<E>

pub fn is_incomplete(&self) -> bool

Tests if the result is Incomplete

pub fn map<E2, F>(self, f: F) -> Err<E2> where
    F: FnOnce(E) -> E2, 

Applies the given function to the inner error

pub fn convert<F>(e: Err<F>) -> Err<E> where
    E: From<F>, 

Automatically converts between errors if the underlying type supports it

impl<T> Err<(T, ErrorKind)>

pub fn map_input<U, F>(self, f: F) -> Err<(U, ErrorKind)> where
    F: FnOnce(T) -> U, 

Maps Err<(T, ErrorKind)> to Err<(U, ErrorKind)> with the given F: T -> U

impl<T> Err<Error<T>>

pub fn map_input<U, F>(self, f: F) -> Err<Error<U>> where
    F: FnOnce(T) -> U, 

Maps Err<error::Error<T>> to Err<error::Error<U>> with the given F: T -> U

impl<'_> Err<(&'_ [u8], ErrorKind)>

pub fn to_owned(self) -> Err<(Vec<u8, Global>, ErrorKind)>

Obtaining ownership

impl<'_> Err<(&'_ str, ErrorKind)>

pub fn to_owned(self) -> Err<(String, ErrorKind)>

Obtaining ownership

impl<'_> Err<Error<&'_ [u8]>>

pub fn to_owned(self) -> Err<Error<Vec<u8, Global>>>

Obtaining ownership

impl<'_> Err<Error<&'_ str>>

pub fn to_owned(self) -> Err<Error<String>>

Obtaining ownership

Trait Implementations

impl<E> Clone for Err<E> where
    E: Clone, 

pub fn clone(&self) -> Err<E>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<E> Debug for Err<E> where
    E: Debug, 

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

Formats the value using the given formatter.

impl<E> Display for Err<E> where
    E: Debug, 

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

Formats the value using the given formatter.

impl<E> Error for Err<E> where
    E: Debug, 

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

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

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Err<Error>> for Error

fn from(e: Err<Error>) -> Self

Performs the conversion.

impl From<Error> for Err<Error>

fn from(e: Error) -> Self

Performs the conversion.

impl<E> PartialEq<Err<E>> for Err<E> where
    E: PartialEq<E>, 

pub fn eq(&self, other: &Err<E>) -> bool

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

pub fn ne(&self, other: &Err<E>) -> bool

This method tests for !=.

impl<E> Eq for Err<E> where
    E: Eq, 

impl<E> StructuralPartialEq for Err<E>