Enum nom::IResult

pub enum IResult<I, O, E = u32> {
    Done(I, O),
    Error(Err<E>),
    Incomplete(Needed),
}

Holds the result of parsing functions

It depends on I, the input type, O, the output type, and E, the error type (by default u32)

Variants

Done(I, O)

indicates a correct parsing, the first field containing the rest of the unparsed data, the second field contains the parsed data

Error(Err<E>)

contains a Err, an enum that can indicate an error code, a position in the input, and a pointer to another error, making a list of errors in the parsing tree

Incomplete(Needed)

Incomplete contains a Needed, an enum than can represent a known quantity of input data, or unknown

Methods

impl<I, O, E> IResult<I, O, E>

pub fn map_err<N, F>(self, f: F) -> IResult<I, O, N> where     F: FnOnce(Err<E>) -> Err<N>,

Maps a IResult<I, O, E> to IResult<I, O, N> by appling a function to a contained Error value, leaving Done and Incomplete value untouched.

pub fn unwrap_err(self) -> Err<E>

Unwrap the contained Error(E) value, or panic if the IResult is not Error.

pub fn to_full_result(self) -> Result<O, IError<E>>

Convert the IResult to a std::result::Result

pub fn to_result(self) -> Result<O, Err<E>>

Convert the IResult to a std::result::Result, or panic if the IResult is Incomplete

impl<I, O, E> IResult<I, O, E>

pub fn is_done(&self) -> bool

pub fn is_err(&self) -> bool

pub fn is_incomplete(&self) -> bool

pub fn or(self, other: IResult<I, O, E>) -> IResult<I, O, E>

pub fn map<N, F: FnOnce(O) -> N>(self, f: F) -> IResult<I, N, E>

Maps a IResult<I, O, E> to IResult<I, N, E> by appling a function to a contained Done value, leaving Error and Incomplete value untouched.

pub fn map_inc<F>(self, f: F) -> IResult<I, O, E> where     F: FnOnce(Needed) -> Needed,

Maps a IResult<I, O, E> to IResult<I, O, E> by appling a function to a contained Incomplete value, leaving Done and Error value untouched.

pub fn unwrap(self) -> (I, O)

Unwrap the contained Done(I, O) value, or panic if the IResult is not Done.

pub fn unwrap_or(self, default: (I, O)) -> (I, O)

Unwrap the contained Done(I, O) value or a default if the IResult is not Done.

pub fn unwrap_inc(self) -> Needed

Unwrap the contained Incomplete(n) value, or panic if the IResult is not Incomplete.

Trait Implementations

impl<'a, I, O, E> GetInput<&'a [I]> for IResult<&'a [I], O, E>

fn remaining_input(&self) -> Option<&'a [I]>

impl<O, E> GetInput<()> for IResult<(), O, E>

fn remaining_input(&self) -> Option<()>

impl<'a, O, E> GetInput<&'a str> for IResult<&'a str, O, E>

fn remaining_input(&self) -> Option<&'a str>

impl<'a, I, O, E> GetOutput<&'a [O]> for IResult<I, &'a [O], E>

fn output(&self) -> Option<&'a [O]>

impl<I, E> GetOutput<()> for IResult<I, (), E>

fn output(&self) -> Option<()>

impl<'a, I, E> GetOutput<&'a str> for IResult<I, &'a str, E>

fn output(&self) -> Option<&'a str>

impl<I: Clone, O: Clone, E: Clone> Clone for IResult<I, O, E>

fn clone(&self) -> IResult<I, O, E>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<I: Eq, O: Eq, E: Eq> Eq for IResult<I, O, E>

impl<I: PartialEq, O: PartialEq, E: PartialEq> PartialEq<IResult<I, O, E>> for IResult<I, O, E>

fn eq(&self, other: &IResult<I, O, E>) -> bool

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

fn ne(&self, other: &IResult<I, O, E>) -> bool

This method tests for !=.

impl<I: Debug, O: Debug, E: Debug> Debug for IResult<I, O, E>

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

Formats the value using the given formatter.