com.github.fge.grappa.matchers.repeat

Class RepeatMatcherBuilder<V>

java.lang.Object

com.github.fge.grappa.misc.RangeMatcherBuilder<V>

com.github.fge.grappa.matchers.repeat.RepeatMatcherBuilder<V>

public final class RepeatMatcherBuilder<V>
extends RangeMatcherBuilder<V>

Field Summary

Fields inherited from class com.github.fge.grappa.misc.RangeMatcherBuilder

parser, rule

Constructor Summary

Constructors

Constructor and Description
RepeatMatcherBuilder(BaseParser<V> parser, Rule rule)

Method Summary

Methods

Modifier and Type	Method and Description
protected Rule	boundedBoth(int minCycles, int maxCycles) Build a rule which is expected to match a number of times between two end points
protected Rule	boundedDown(int minCycles) Build a rule which is expected to match a minimum number of times
protected Rule	boundedUp(int maxCycles) Build a rule which is expected to match a maximum number of times
protected Rule	exactly(int nrCycles) Build a rule which is expected to match a fixed number of times

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

max, min, range, times, times

Methods inherited from class java.lang.Object

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

Constructor Detail

RepeatMatcherBuilder

public RepeatMatcherBuilder(BaseParser<V> parser,
                    Rule rule)

Method Detail

boundedDown

protected Rule boundedDown(int minCycles)

Description copied from class: RangeMatcherBuilder

Build a rule which is expected to match a minimum number of times

The returned matcher will attempt to match indefinitely its input until it fails. Success should be declared if and only if the number of times the matcher has succeeded is greater than, or equal to, the number of cycles given as an argument (including 0).

Specified by:

boundedDown in class RangeMatcherBuilder<V>

Parameters:

minCycles - the minimum number of cycles (inclusive)

Returns:

a rule

boundedUp

protected Rule boundedUp(int maxCycles)

Description copied from class: RangeMatcherBuilder

Build a rule which is expected to match a maximum number of times

The returned matcher will attempt to match repeatedly up to, and including, the number of cycles returned as an argument. Note that the argument will always be greater than or equal to 2.

One consequence is that this matcher always succeeds.

Specified by:

boundedUp in class RangeMatcherBuilder<V>

Parameters:

maxCycles - the maximum number of cycles (inclusive)

Returns:

a rule

exactly

protected Rule exactly(int nrCycles)

Description copied from class: RangeMatcherBuilder

Build a rule which is expected to match a fixed number of times

The returned matcher will attempt to match repeatedly up to, and including, the number of cycles given as an argument. Success should be declared if and only if the number of cycles matched is exactly this number.

Specified by:

exactly in class RangeMatcherBuilder<V>

Parameters:

nrCycles - the number of cycles (inclusive)

Returns:

a rule

boundedBoth

protected Rule boundedBoth(int minCycles,
               int maxCycles)

Description copied from class: RangeMatcherBuilder

Build a rule which is expected to match a number of times between two end points

The returned matcher will attempt to match repeatedly up to, and including, the maximum number of cycles specified as the second argument. Success should be declared if and only if the number of cycles performed is at least equal to the number of cycles specified as the first argument.

Note that the first argument will always be strictly greater than 0, and that the second argument will always be strictly greater than the first.

Specified by:

boundedBoth in class RangeMatcherBuilder<V>

Parameters:

minCycles - the minimum number of cycles (inclusive)

maxCycles - the maximum number of cycles (exclusive)

Returns:

a rule