Struct Message 

pub struct Message<P, S>(/* private fields */);

Trait Implementations

impl<P, S> Clone for Message<P, S>

where P: Clone, S: Clone,

fn clone(&self) -> Message<P, S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Input, P, S> Parser<Input> for Message<P, S>

where Input: Stream, P: Parser<Input>, S: for<'s> ErrorInfo<'s, <Input as StreamOnce>::Token, <Input as StreamOnce>::Range>,

type Output = <P as Parser<Input>>::Output

The type which is returned if the parser is successful.

type PartialState = <P as Parser<Input>>::PartialState

Determines the state necessary to resume parsing after more input is supplied.

fn add_error(&mut self, errors: &mut Tracked<<Input as StreamOnce>::Error>)

Adds the first error that would normally be returned by this parser if it failed with an PeekErr result.

fn parse( &mut self, input: Input, ) -> Result<(Self::Output, Input), <Input as StreamOnce>::Error>

Entry point of the parser. Takes some input and tries to parse it.

fn parse_with_state( &mut self, input: &mut Input, state: &mut Self::PartialState, ) -> Result<Self::Output, <Input as StreamOnce>::Error>

Entry point of the parser when using partial parsing. Takes some input and tries to parse it.

fn parse_stream( &mut self, input: &mut Input, ) -> ParseResult<Self::Output, <Input as StreamOnce>::Error>

Parses using the stream input by calling Stream::uncons one or more times.

fn parse_lazy( &mut self, input: &mut Input, ) -> ParseResult<Self::Output, <Input as StreamOnce>::Error>

Parses using the stream input by calling Stream::uncons one or more times.

fn parse_stream_partial( &mut self, input: &mut Input, state: &mut Self::PartialState, ) -> ParseResult<Self::Output, <Input as StreamOnce>::Error>

Like parse_stream but supports partial parsing.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Borrows a parser instead of consuming it.

fn with<P2>(self, p: P2) -> With<Self, P2>

where Self: Sized, P2: Parser<Input>,

Discards the value of the self parser and returns the value of p. Fails if any of the parsers fails.

fn skip<P2>(self, p: P2) -> Skip<Self, P2>

where Self: Sized, P2: Parser<Input>,

Discards the value of the p parser and returns the value of self. Fails if any of the parsers fails.

fn and<P2>(self, p: P2) -> (Self, P2)

where Self: Sized, P2: Parser<Input>,

Parses with self followed by p. Succeeds if both parsers succeed, otherwise fails. Returns a tuple with both values on success.

fn or<P2>(self, p: P2) -> Or<Self, P2>

where Self: Sized, P2: Parser<Input, Output = Self::Output>,

Returns a parser which attempts to parse using self. If self fails without committing it tries to consume the same input using p.

fn then<N, F>(self, f: F) -> Then<Self, F>

where Self: Sized, F: FnMut(Self::Output) -> N, N: Parser<Input>,

Parses using self and then passes the value to f which returns a parser used to parse the rest of the input.

fn then_partial<N, F>(self, f: F) -> ThenPartial<Self, F>

where Self: Sized, F: FnMut(&mut Self::Output) -> N, N: Parser<Input>,

Variant of then which parses using self and then passes the value to f as a &mut reference.

fn then_ref<N, F>(self, f: F) -> ThenRef<Self, F>

where Self: Sized, F: FnMut(&Self::Output) -> N, N: Parser<Input>,

Parses using self and then passes a reference to the value to f which returns a parser used to parse the rest of the input. The value is then combined with the output of f.

fn map<F, B>(self, f: F) -> Map<Self, F>

where Self: Sized, F: FnMut(Self::Output) -> B,

Uses f to map over the parsed value.

fn map_input<F, B>(self, f: F) -> MapInput<Self, F>

where Self: Sized, F: FnMut(Self::Output, &mut Input) -> B,

fn flat_map<F, B>(self, f: F) -> FlatMap<Self, F>

where Self: Sized, F: FnMut(Self::Output) -> Result<B, <Input as StreamOnce>::Error>,

Uses f to map over the output of self. If f returns an error the parser fails.

fn message<S>(self, msg: S) -> Message<Self, S>

where Self: Sized, S: for<'s> ErrorInfo<'s, <Input as StreamOnce>::Token, <Input as StreamOnce>::Range>,

Parses with self and if it fails, adds the message msg to the error.

fn expected<S>(self, msg: S) -> Expected<Self, S>

where Self: Sized, S: for<'s> ErrorInfo<'s, <Input as StreamOnce>::Token, <Input as StreamOnce>::Range>,

Parses with self and if it fails without consuming any input any expected errors are replaced by msg. msg is then used in error messages as “Expected msg”.

fn silent(self) -> Silent<Self>

where Self: Sized,

Parses with self, if it fails without consuming any input any expected errors that would otherwise be emitted by self are suppressed.

fn and_then<F, O, E>(self, f: F) -> AndThen<Self, F>

where Self: Sized + Parser<Input>, F: FnMut(Self::Output) -> Result<O, E>, E: Into<<<Input as StreamOnce>::Error as ParseError<<Input as StreamOnce>::Token, <Input as StreamOnce>::Range, <Input as StreamOnce>::Position>>::StreamError>,

Parses with self and applies f on the result if self parses successfully. f may optionally fail with an error which is automatically converted to a ParseError.

fn iter( self, input: &mut Input, ) -> Iter<'_, Input, Self, Self::PartialState, FirstMode>

where Self: Sized + Parser<Input>,

Creates an iterator from a parser and a state. Can be used as an alternative to many when collecting directly into a Extend type is not desirable.

fn partial_iter<'a, 's, M>( self, mode: M, input: &'a mut Input, partial_state: &'s mut Self::PartialState, ) -> Iter<'a, Input, Self, &'s mut Self::PartialState, M>

where Self: Sized + Parser<Input>, M: ParseMode,

Creates an iterator from a parser and a state. Can be used as an alternative to many when collecting directly into a Extend type is not desirable.

fn boxed<'a>( self, ) -> Box<dyn Parser<Input, Output = Self::Output, PartialState = Self::PartialState> + 'a>

where Self: Sized + 'a,

Turns the parser into a trait object by putting it in a Box. Can be used to easily return parsers from functions without naming the type.

fn left<R>(self) -> Either<Self, R>

where Self: Sized, R: Parser<Input, Output = Self::Output>,

Wraps the parser into the Either enum which allows combinators such as then to return multiple different parser types (merging them to one)

fn right<L>(self) -> Either<L, Self>

where Self: Sized, L: Parser<Input, Output = Self::Output>,

Wraps the parser into the Either enum which allows combinators such as then to return multiple different parser types (merging them to one)

fn spanned(self) -> Spanned<Self>

where Self: Sized,

Marks errors produced inside the self parser with the span from the start of the parse to the end of it.