Struct Label 

pub struct Label<P>(/* private fields */);

Wrapper that attaches a label to errors.

Trait Implementations

impl<P: Clone> Clone for Label<P>

fn clone(&self) -> Label<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug> Debug for Label<P>

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

Formats the value using the given formatter.

impl<P: Hash> Hash for Label<P>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<P, I, E, N, L> Parser<I, E, N, L> for Label<P>

where I: Input, E: ErrMode<I> + ErrSink<I, Expected<ErrOf<P, I, E, N, L>>>, N: Rb, L: RbBack, P: Parser<I, E, N, L, Out: OutOf<I, E>>,

fn run(&self, i: In<'_, I, E, N, L>) -> Self::Out

fn by_ref<'a>(&'a self) -> RefParser<'a, Self>

Borrow a parser immutably as ParserOnce.

fn flow_many_map<F, O, T1, T2>(self, f: F) -> FlowManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out = ControlFlow<T2, T1>>, F: for<'a, 'b> Fn(&mut FlowManyIterator<'a, 'b, Self, I, E, N, L, T1, T2>) -> O,

Like ParserMut::flow_many, but lets you fold via a flow::FlowManyIterator.

fn many_map<F, O>(self, f: F) -> ManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> Fn(ManyMapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like ParserMut::many, but lets you fold via a streaming iterator.

fn many1_map<F, O>(self, f: F) -> Many1Map<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> Fn(Many1MapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like Parser::many_map, but requires at least one element.

fn sep_map<Q, F, T, S, O>( self, sep_p: Q, f: F, ) -> SepMap<Zero, Allow, Self, Q, F, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Value = S, Error = ErrOf<Self, I, E, N, L>>>, F: for<'a, 'b> Fn(SepMapIterator<'a, 'b, Self, Q, I, E, N, L, Zero, Allow>) -> O,

Like ParserMut::sep, but lets you fold via a streaming iterator.

fn sep1_map<Q, F, T, S, O>( self, sep_p: Q, f: F, ) -> SepMap<One, Allow, Self, Q, F, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Value = S, Error = ErrOf<Self, I, E, N, L>>>, F: for<'a, 'b> Fn(SepMapIterator<'a, 'b, Self, Q, I, E, N, L, One, Allow>) -> O,

Like Parser::sep_map, but requires at least one item (1+).

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

where Self: Sized, Self::Out: OutOf<I, E>, F: Fn(ValueOf<Self, I, E, N, L>) -> O,

Map the output of a parser.

fn bind<P2, F>(self, f: F) -> Bind<Self, F>

where Self: Sized, Self::Out: OutOf<I, E>, F: Fn(ValueOf<Self, I, E, N, L>) -> P2, P2: ParserOnce<I, E, N, L, Out: OutOf<I, E, Error = ErrOf<Self, I, E, N, L>>>,

Sequential bind (flat_map).

impl<P, I, E, N, L> ParserMut<I, E, N, L> for Label<P>

where I: Input, E: ErrMode<I> + ErrSink<I, Expected<ErrOf<P, I, E, N, L>>>, N: Rb, L: RbBack, P: ParserMut<I, E, N, L, Out: OutOf<I, E>>,

fn run_mut(&mut self, i: In<'_, I, E, N, L>) -> Self::Out

fn by_mut<'a>(&'a mut self) -> MutParser<'a, Self>

Borrow a parser mutably as ParserOnce.

fn map_mut<O, F>(self, f: F) -> Map<Self, F>

where Self: Sized, Self::Out: OutOf<I, E>, F: FnMut(ValueOf<Self, I, E, N, L>) -> O,

Like Parser::map, but intended for mutable/repeatable mappers (FnMut).

fn bind_mut<P2, F>(self, f: F) -> Bind<Self, F>

where Self: Sized, Self::Out: OutOf<I, E>, F: FnMut(ValueOf<Self, I, E, N, L>) -> P2, P2: ParserOnce<I, E, N, L, Out: OutOf<I, E, Error = ErrOf<Self, I, E, N, L>>>,

Like Parser::bind, but intended for mutable/repeatable binders (FnMut).

fn flow<C, S, Step, T>(self, state: S, step: Step) -> Flow<Self, S, Step>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Step: FnMut(S, T) -> ControlFlow<C, S>,

Stateful loop that terminates on soft failure via In::maybe.

fn flow_many<O, T1, T2>(self) -> FlowMany<Self, O>

where Self: Sized + ParserMut<I, E, N, L, Out = ControlFlow<T2, T1>>, O: FromIterator<T1>,

Collect Continue(T1) values until Break(T2).

fn flow_many_map_once<F, O, T1, T2>(self, f: F) -> FlowManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out = ControlFlow<T2, T1>>, F: for<'a, 'b> FnOnce(&mut FlowManyIterator<'a, 'b, Self, I, E, N, L, T1, T2>) -> O,

Like Parser::flow_many_map, but intended for single-shot mappers (FnOnce).

fn flow_many_map_mut<F, O, T1, T2>(self, f: F) -> FlowManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out = ControlFlow<T2, T1>>, F: for<'a, 'b> FnMut(&mut FlowManyIterator<'a, 'b, Self, I, E, N, L, T1, T2>) -> O,

Like Parser::flow_many_map, but intended for mutable/repeatable mappers (FnMut).

fn many<O>(self) -> Many<Self, O>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, O: FromIterator<ValueOf<Self, I, E, N, L>>,

Repeat a parser until soft failure, collecting outputs.

fn many1<O>(self) -> Many1<Self, O>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, O: FromIterator<ValueOf<Self, I, E, N, L>>,

Repeat a parser one or more times, collecting outputs.

fn many_map_once<F, O>(self, f: F) -> ManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> FnOnce(ManyMapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like Parser::many_map, but intended for single-shot mappers (FnOnce).

fn many_map_mut<F, O>(self, f: F) -> ManyMap<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> FnMut(ManyMapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like Parser::many_map, but intended for mutable/repeatable mappers (FnMut).

fn many1_map_once<F, O>(self, f: F) -> Many1Map<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> FnOnce(Many1MapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like Parser::many1_map, but intended for single-shot mappers (FnOnce).

fn many1_map_mut<F, O>(self, f: F) -> Many1Map<Self, F>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, F: for<'a, 'b> FnMut(Many1MapIterator<'a, 'b, Self, I, E, N, L>) -> O,

Like Parser::many1_map, but intended for mutable/repeatable mappers (FnMut).

fn many_skip(self) -> SkipMany<Self>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>,

Repeat a parser until soft failure, discarding outputs.

fn many1_skip(self) -> SkipMany1<Self>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>,

Repeat a parser one or more times, discarding outputs.

fn count<R, O>(self, range: R) -> Count<Self, O>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E>>, R: CountRange, O: FromIterator<ValueOf<Self, I, E, N, L>>,

Repeat a parser a specified number of times.

fn sep<O, Q, T>(self, sep_p: Q) -> Sep<O, Zero, Allow, Self, Q, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Error = ErrOf<Self, I, E, N, L>>>, O: FromIterator<T>,

Parse a separated list: item (sep item)*.

fn sep1<O, Q, T>(self, sep_p: Q) -> Sep<O, One, Allow, Self, Q, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Error = ErrOf<Self, I, E, N, L>>>, O: FromIterator<T>,

Like ParserMut::sep, but requires at least one item (1+).

fn sep_map_once<Q, F, T, S, O>( self, sep_p: Q, f: F, ) -> SepMap<Zero, Allow, Self, Q, F, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Value = S, Error = ErrOf<Self, I, E, N, L>>>, F: for<'a, 'b> FnOnce(SepMapIterator<'a, 'b, Self, Q, I, E, N, L, Zero, Allow>) -> O,

Like Parser::sep_map, but intended for single-shot mappers (FnOnce).

fn sep_map_mut<Q, F, T, S, O>( self, sep_p: Q, f: F, ) -> SepMap<Zero, Allow, Self, Q, F, T>

where Self: Sized + ParserMut<I, E, N, L, Out: OutOf<I, E, Value = T>>, Q: ParserMut<I, E, N, L, Out: OutOf<I, E, Value = S, Error = ErrOf<Self, I, E, N, L>>>, F: for<'a, 'b> FnMut(SepMapIterator<'a, 'b, Self, Q, I, E, N, L, Zero, Allow>) -> O,

Like Parser::sep_map, but intended for mutable/repeatable mappers (FnMut).

fn sep_reduce<Q, F>(self, op: Q, f: F) -> SepReduce<Self, Q, F>

Left-associative separator reduction: term (op term)*. let mut input = “a+a+a”; let term = item(‘a’).to(1); let plus = item(‘+’).to(()); let out = parse_ok_once(&mut input, term.sep_reduce(plus, |a, _, b| a + b)).unwrap(); assert_eq!(out, 3); assert_eq!(input, “”);

impl<P, I, E, N, L> ParserOnce<I, E, N, L> for Label<P>

where I: Input, E: ErrMode<I> + ErrSink<I, Expected<ErrOf<P, I, E, N, L>>>, N: Rb, L: RbBack, P: ParserOnce<I, E, N, L, Out: OutOf<I, E>>,

type Out = <E as ErrMode<I>>::Out<<<P as ParserOnce<I, E, N, L>>::Out as OutOf<I, E>>::Value, Expected<<<P as ParserOnce<I, E, N, L>>::Out as OutOf<I, E>>::Error>>

fn run_once(self, i: In<'_, I, E, N, L>) -> Self::Out

fn or_not(self) -> OrNot<Self>

Optionalize a parser with OutOf semantics.

fn cut(self) -> CutIfOk<Self>

where Self::Out: OutOf<I, E>,

Commit-on-success for OutOf parsers.

fn with_range(self) -> WithRange<Self>

where Self::Out: OutOf<I, E>,

Attach the consumed range (start and end positions) to a parser output.

fn with_seq<S>(self) -> WithSeq<Self, S>

where Self::Out: OutOf<I, E>,

Attach the consumed sequence to a parser output.

fn lookahead(self) -> Lookahead<Self>

where Self::Out: OutOf<I, E>,

Run this parser as lookahead.

fn no_cut(self) -> NoCut<Self>

Run this parser in a non-root cut scope (cut does not trigger commits).

fn not(self) -> Not<Self>

where Self::Out: OutOf<I, E>,

Negative lookahead for OutOf parsers.

fn label(self, label: impl Into<Cow<'static, str>>) -> Label<Self>

Attach a label to a parser failure (Parsec-like <?>).

fn label_with<F, S>(self, f: F) -> LabelWith<Self, F>

where F: Fn() -> S, S: Into<Cow<'static, str>>,

Attach a lazily-evaluated label to a parser failure.

fn label_with_once<F, S>(self, f: F) -> LabelWith<Self, F>

where F: FnOnce() -> S, S: Into<Cow<'static, str>>,

Like ParserOnce::label_with, but intended for single-shot label builders (FnOnce).

fn label_with_mut<F, S>(self, f: F) -> LabelWith<Self, F>

where F: FnMut() -> S, S: Into<Cow<'static, str>>,

Like ParserOnce::label_with, but intended for mutable/repeatable label builders (FnMut).

fn align_errors<T, E2>(self) -> AlignErrors<Self, (T, E2)>

where I: SeqInput<T>, E2: MergeErrors, Self: ParserOnce<I, Merger<I, E2>, N, L, Out: OutOf<I, Merger<I, E2>>>,

Align and merge errors, returning the consumed sequence on failure.

fn align_ranged_errors<T, E2>(self) -> AlignRangedErrors<Self, (T, E2)>

where I: SeqInput<T>, E2: MergeErrors, Self: ParserOnce<I, Merger<I, E2>, N, L, Out: OutOf<I, Merger<I, E2>>>,

Align and merge errors, returning the consumed sequence and range on failure.

fn map_once<O, F>(self, f: F) -> Map<Self, F>

where Self::Out: OutOf<I, E>, F: FnOnce(ValueOf<Self, I, E, N, L>) -> O,

Like Parser::map, but intended for single-shot mappers (FnOnce).

fn lift_result<O, E1>(self) -> LiftResult<Self>

where Self: ParserOnce<I, (), N, L, Out = Result<O, E1>>,

Lift a direct Result output into a merger-based parser with ranged errors.

fn lift_ranged_result<O1, O2, E1>(self) -> LiftRangedResult<Self>

where Self: ParserOnce<I, (), N, L, Out = (O1, Result<O2, (Range<I::Pos>, E1)>)>,

Lift a direct (A, Result<B, (range, err)>) output into a merger-based parser.

fn to<O>(self, value: O) -> To<Self, O>

where Self::Out: OutOf<I, E>,

Replace the output of a parser with a constant value.

fn bind_once<P2, F>(self, f: F) -> Bind<Self, F>

where Self::Out: OutOf<I, E>, F: FnOnce(ValueOf<Self, I, E, N, L>) -> P2, P2: ParserOnce<I, E, N, L, Out: OutOf<I, E, Error = ErrOf<Self, I, E, N, L>>>,

Like Parser::bind, but intended for single-shot binders (FnOnce).

fn then<P>(self, right: P) -> (Self, P)

Parse self then right, returning both outputs as a tuple.

fn left<P>(self, right: P) -> Left<Self, P>

Parse self then right, returning the output of self.

fn right<P>(self, right: P) -> Right<Self, P>

Parse self then right, returning the output of right.

fn between<Lp, Rp>(self, left: Lp, right: Rp) -> Between<Lp, Self, Rp>

Parse left, then self, then right, returning the output of self.

fn or<P>(self, other: P) -> Choice<(Self, P)>

where Self::Out: OutOf<I, E>, P: ParserOnce<I, E, N, L, Out = Self::Out>,

Choice: try self, then other on soft failure.

fn map_err<E1, E2, E3, F, O>(self, f: F) -> MapErr<Self, F, (O, E1)>

where Self: ParserOnce<I, Merger<I, E1>, N, L, Out = Option<O>>, F: FnOnce(&[E1]) -> E2, E2: Into<E3>,