LabelParser<R> class

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

Inheritance
Implemented types
Available extensions

Constructors

LabelParser.new(Parser<R> delegate, String label)

Properties

children → List<Parser>
Returns a list of directly referenced parsers.
no setterinherited
delegate ↔ Parser<R>
The parser this parser delegates to.
getter/setter pairinherited
hashCode → int
The hash code for this object.
no setterinherited
label → String
Label of this parser.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

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.