[][src]Enum nom::Err

pub enum Err<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



There was not enough data


The parser had an error (recoverable)


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


impl<E> Err<E>[src]

pub fn is_incomplete(&self) -> bool[src]

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>) -> Self where
    E: From<F>, 

automatically converts between errors if the underlying type supports it

impl<T> Err<(T, ErrorKind)>[src]

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<'_> Err<(&'_ [u8], ErrorKind)>[src]

pub fn to_owned(self) -> Err<(Vec<u8>, ErrorKind)>[src]

Obtaining ownership

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

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

automatically converts between errors if the underlying type supports it

Trait Implementations

impl<E: Clone> Clone for Err<E>[src]

impl<E: Debug> Debug for Err<E>[src]

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

impl<E: Eq> Eq for Err<E>[src]

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

impl<E: PartialEq> PartialEq<Err<E>> for Err<E>[src]

impl<E> StructuralPartialEq for Err<E>[src]

Auto Trait Implementations

impl<E> RefUnwindSafe for Err<E> where
    E: RefUnwindSafe

impl<E> Send for Err<E> where
    E: Send

impl<E> Sync for Err<E> where
    E: Sync

impl<E> Unpin for Err<E> where
    E: Unpin

impl<E> UnwindSafe for Err<E> where
    E: UnwindSafe

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T> ToOwned for T where
    T: Clone

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.