com.github.fge.grappa.matchers.repeat

Class RepeatMatcher

java.lang.Object

com.github.fge.grappa.misc.ImmutableGraphNode<Matcher>

com.github.fge.grappa.matchers.base.AbstractMatcher

com.github.fge.grappa.matchers.repeat.RepeatMatcher

All Implemented Interfaces:

Matcher, GraphNode<Matcher>, Rule, Cloneable

Direct Known Subclasses:

BoundedBothRepeatMatcher, BoundedDownRepeatMatcher, BoundedUpRepeatMatcher, ExactMatchesRepeatMatcher

public abstract class RepeatMatcher
extends AbstractMatcher

A matcher which repeats matching a given number of times

Note that it is forbidden for the subrule as an argument to match an empty input. Unfortunately, due to current limitations, this can only be detected at runtime.

Example:

     public Rule threeTimesHello()
     {
         return repeat("hello").times(3);
     }
 

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RepeatMatcher(Rule subRule)

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract boolean	enoughCycles(int cycles)
MatcherType	getType() Returns the type of this matcher
<V> boolean	match(MatcherContext<V> context) Tries a match on the given MatcherContext.
protected abstract boolean	runAgain(int cycles)

Methods inherited from class com.github.fge.grappa.matchers.base.AbstractMatcher

getLabel, getSubContext, hasCustomLabel, label, toString

Methods inherited from class com.github.fge.grappa.misc.ImmutableGraphNode

getChildren

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.github.fge.grappa.misc.GraphNode

getChildren

Constructor Detail

RepeatMatcher

protected RepeatMatcher(Rule subRule)

Method Detail

getType

public MatcherType getType()

Description copied from interface: Matcher

Returns the type of this matcher

Returns:

the type

See Also:

MatcherType

match

public <V> boolean match(MatcherContext<V> context)

Description copied from interface: Matcher

Tries a match on the given MatcherContext.

Parameters:

context - the MatcherContext

Returns:

true if the match was successful

enoughCycles

protected abstract boolean enoughCycles(int cycles)

runAgain

protected abstract boolean runAgain(int cycles)