LabelParser<R> class

A parser that always defers to its delegate, but that also holds a label for debugging purposes.

Inheritance

• Object
• Parser<R>
• DelegateParser<R, R>
• LabelParser

Implemented types

• LabeledParser<R>

Available extensions

• AcceptParser
• AndParserExtension
• CastListParserExtension
• CastParserExtension
• ChoiceParserExtension
• ContinuationParserExtension
• EndOfInputParserExtension
• FlattenParserExtension
• GreedyRepeatingParserExtension
• LabelParserExtension
• LazyRepeatingParserExtension
• MapParserExtension
• MatchesParser
• MatchesSkippingParser
• NotParserExtension
• OptionalParserExtension
• PatternParserExtension
• PermuteParserExtension
• PickParserExtension
• PossessiveRepeatingParserExtension
• SeparatedBy
• SequenceParserExtension
• SettableParserExtension
• TokenParserExtension
• TrimmingParserExtension
• WhereParserExtension

Constructors

LabelParser(Parser<R> delegate, String label)

Properties

children → List<Parser>

Returns a list of directly referenced parsers.

no setter, inherited

delegate ↔ Parser<R>

The parser this parser delegates to.

getter/setter pair, inherited

hashCode → int

The hash code for this object.

no setter, inherited

label → String

Label of this parser.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

accept(String input) → bool

Available on Parser<T>, provided by the AcceptParser extension

Tests if the input can be successfully parsed.

and() → Parser<T>

Available on Parser<T>, provided by the AndParserExtension extension

Returns a parser (logical and-predicate) that succeeds whenever the receiver does, but never consumes input.

callCC<R>(ContinuationHandler<T, R> handler) → Parser<R>

Available on Parser<T>, provided by the ContinuationParserExtension extension

Returns a parser that when activated captures a continuation function and passes it together with the current context into the handler.

cast<R>() → Parser<R>

Available on Parser<T>, provided by the CastParserExtension extension

Returns a parser that casts itself to Parser<R>.

castList<R>() → Parser<List<R>>

Available on Parser<T>, provided by the CastListParserExtension extension

Returns a parser that casts itself to Parser<List<R>>. Assumes this parser to be of type Parser<List>.

copy() → LabelParser<R>

Returns a shallow copy of the receiver.

override

end([String message = 'end of input expected']) → Parser<T>

Available on Parser<T>, provided by the EndOfInputParserExtension extension

Returns a parser that succeeds only if the receiver consumes the complete input, otherwise return a failure with the optional message.

fastParseOn(String buffer, int position) → int

Primitive method doing the actual parsing.

override

flatten([String? message]) → Parser<String>

Available on Parser<T>, provided by the FlattenParserExtension extension

Returns a parser that discards the result of the receiver and answers the sub-string its delegate consumes.

hasEqualChildren(covariant Parser other, Set<Parser> seen) → bool

Compare the children of two parsers.

inherited

hasEqualProperties(covariant LabelParser<R> other) → bool

Compare the properties of two parsers.

override

isEqualTo(Parser other, [Set<Parser>? seen]) → bool

Recursively tests for structural equality of two parsers.

inherited

labeled(String label) → LabeledParser<R>

Available on Parser<R>, provided by the LabelParserExtension extension

Returns a parser that simply defers to its delegate, but that has a label for debugging purposes.

map<R>(Callback<T, R> callback, {bool hasSideEffects = false}) → Parser<R>

Available on Parser<T>, provided by the MapParserExtension extension

Returns a parser that evaluates a callback as the production action on success of the receiver.

matches(String input) → List<T>

Available on Parser<T>, provided by the MatchesParser extension

Returns a list of all successful overlapping parses of the input.

matchesSkipping(String input) → List<T>

Available on Parser<T>, provided by the MatchesSkippingParser extension

Returns a list of all successful non-overlapping parses of the input.

neg([String message = 'input not expected']) → Parser<String>

Available on Parser<T>, provided by the NotParserExtension extension

Returns a parser that consumes any input token (character), but the receiver.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

not([String message = 'success not expected']) → Parser<Failure<T>>

Available on Parser<T>, provided by the NotParserExtension extension

Returns a parser (logical not-predicate) that succeeds with the Failure whenever the receiver fails, but never consumes input.

optional() → Parser<T?>

Available on Parser<T>, provided by the OptionalParserExtension extension

Returns new parser that accepts the receiver, if possible. The resulting parser returns the result of the receiver, or null if not applicable.

optionalWith(T value) → Parser<T>

Available on Parser<T>, provided by the OptionalParserExtension extension

Returns new parser that accepts the receiver, if possible. The resulting parser returns the result of the receiver, or value if not applicable.

or(Parser other, {FailureJoiner? failureJoiner}) → ChoiceParser

Available on Parser, provided by the ChoiceParserExtension extension

Returns a parser that accepts the receiver or other. The resulting parser returns the parse result of the receiver, if the receiver fails it returns the parse result of other (exclusive ordered choice).

parse(String input) → Result<R>

Returns the parse result of the input.

inherited

parseOn(Context context) → Result<R>

Primitive method doing the actual parsing.

override

permute(List<int> indexes) → Parser<List<T>>

Available on Parser<List<T>>, provided by the PermuteParserExtension extension

Returns a parser that transforms a successful parse result by returning the permuted elements at indexes of a list. Negative indexes can be used to access the elements from the back of the list.

pick(int index) → Parser<T>

Available on Parser<List<T>>, provided by the PickParserExtension extension

Returns a parser that transforms a successful parse result by returning the element at index of a list. A negative index can be used to access the elements from the back of the list.

plus() → Parser<List<T>>

Available on Parser<T>, provided by the PossessiveRepeatingParserExtension extension

Returns a parser that accepts the receiver one or more times. The resulting parser returns a list of the parse results of the receiver.

plusGreedy(Parser<void> limit) → Parser<List<T>>

Available on Parser<T>, provided by the GreedyRepeatingParserExtension extension

Returns a parser that parses the receiver one or more times until it reaches limit. This is a greedy non-blind implementation of the plus operator. The limit is not consumed.

plusLazy(Parser<void> limit) → Parser<List<T>>

Available on Parser<T>, provided by the LazyRepeatingParserExtension extension

Returns a parser that parses the receiver one or more times until it reaches a limit. This is a lazy non-blind implementation of the plus operator. The limit is not consumed.

repeat(int min, [int? max]) → Parser<List<T>>

Available on Parser<T>, provided by the PossessiveRepeatingParserExtension extension

Returns a parser that accepts the receiver between min and max times. The resulting parser returns a list of the parse results of the receiver.

repeatGreedy(Parser<void> limit, int min, int max) → Parser<List<T>>

Available on Parser<T>, provided by the GreedyRepeatingParserExtension extension

Returns a parser that parses the receiver at least min and at most max times until it reaches a limit. This is a greedy non-blind implementation of the repeat operator. The limit is not consumed.

repeatLazy(Parser<void> limit, int min, int max) → Parser<List<T>>

Available on Parser<T>, provided by the LazyRepeatingParserExtension extension

Returns a parser that parses the receiver at least min and at most max times until it reaches a limit. This is a lazy non-blind implementation of the repeat operator. The limit is not consumed.

replace(Parser source, Parser target) → void

Changes the receiver by replacing source with target. Does nothing if source does not exist in Parser.children.

inherited

separatedBy<R>(Parser separator, {bool includeSeparators = true, bool optionalSeparatorAtEnd = false}) → Parser<List<R>>

Available on Parser<T>, provided by the SeparatedBy extension

Returns a parser that consumes the receiver one or more times separated by the separator parser. The resulting parser returns a flat list of the parse results of the receiver interleaved with the parse result of the separator parser. The type parameter R defines the type of the returned list.

seq(Parser other) → Parser<List>

Available on Parser, provided by the SequenceParserExtension extension

Returns a parser that accepts the receiver followed by other. The resulting parser returns a list of the parse result of the receiver followed by the parse result of other. Calling this method on an existing sequence code does not nest this sequence into a new one, but instead augments the existing sequence with other.

settable() → SettableParser<T>

Available on Parser<T>, provided by the SettableParserExtension extension

Returns a parser that points to the receiver, but can be changed to point to something else at a later point in time.

star() → Parser<List<T>>

Available on Parser<T>, provided by the PossessiveRepeatingParserExtension extension

Returns a parser that accepts the receiver zero or more times. The resulting parser returns a list of the parse results of the receiver.

starGreedy(Parser<void> limit) → Parser<List<T>>

Available on Parser<T>, provided by the GreedyRepeatingParserExtension extension

Returns a parser that parses the receiver zero or more times until it reaches a limit. This is a greedy non-blind implementation of the star operator. The limit is not consumed.

starLazy(Parser<void> limit) → Parser<List<T>>

Available on Parser<T>, provided by the LazyRepeatingParserExtension extension

Returns a parser that parses the receiver zero or more times until it reaches a limit. This is a lazy non-blind implementation of the star operator. The limit is not consumed.

times(int count) → Parser<List<T>>

Available on Parser<T>, provided by the PossessiveRepeatingParserExtension extension

Returns a parser that accepts the receiver exactly count times. The resulting parser returns a list of the parse results of the receiver.

token() → Parser<Token<T>>

Available on Parser<T>, provided by the TokenParserExtension extension

Returns a parser that returns a Token. The token carries the parsed value of the receiver Token.value, as well as the consumed input Token.input from Token.start to Token.stop of the input being parsed.

toPattern() → Pattern

Available on Parser<T>, provided by the PatternParserExtension extension

Converts this Parser into a Pattern for basic searches within strings.

toString() → String

A string representation of this object.

override

trim([Parser<void>? left, Parser<void>? right]) → Parser<T>

Available on Parser<T>, provided by the TrimmingParserExtension extension

Returns a parser that consumes input before and after the receiver, discards the excess input and only returns returns the result of the receiver. The optional arguments are parsers that consume the excess input. By default whitespace() is used. Up to two arguments can be provided to have different parsers on the left and right side.

where(Predicate<T> predicate, {Callback<T, String>? failureMessage, Callback<T, int>? failurePosition}) → Parser<T>

Available on Parser<T>, provided by the WhereParserExtension extension

Returns a parser that evaluates the predicate with the successful parse result. If the predicate returns true the parser proceeds with the parse result, otherwise a parse failure is created using the optionally specified failureMessage and failurePosition callbacks.

Operators

operator &(Parser other) → Parser<List>

Available on Parser, provided by the SequenceParserExtension extension

Convenience operator returning a parser that accepts the receiver followed by other. See seq for details.

operator ==(Object other) → bool

The equality operator.

inherited

operator |(Parser other) → ChoiceParser

Available on Parser, provided by the ChoiceParserExtension extension

Convenience operator returning a parser that accepts the receiver or other. See or for details.