dk.brics.automaton
Class AutomatonMatcher

java.lang.Object
  dk.brics.automaton.AutomatonMatcher

All Implemented Interfaces:

java.util.regex.MatchResult

public class AutomatonMatcher
extends java.lang.Object
implements java.util.regex.MatchResult

A tool that performs match operations on a given character sequence using a compiled automaton.

Author:

John Gibson <jgibson@mitre.org>

See Also:

RunAutomaton.newMatcher(java.lang.CharSequence), RunAutomaton.newMatcher(java.lang.CharSequence, int, int)

Method Summary

int	end() Returns the offset after the last character matched.
int	end(int group) Returns the offset after the last character matched of the specified capturing group.
boolean	find() Find the next matching subsequence of the input.
java.lang.String	group() Returns the subsequence of the input found by the previous match.
java.lang.String	group(int group) Returns the subsequence of the input found by the specified capturing group during the previous match operation.
int	groupCount() Returns the number of capturing groups in the underlying automaton.
int	start() Returns the offset of the first character matched.
int	start(int group) Returns the offset of the first character matched of the specified capturing group.
java.util.regex.MatchResult	toMatchResult() Returns the current state of this AutomatonMatcher as a MatchResult.

Methods inherited from class java.lang.Object

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

Method Detail

find

public boolean find()

Find the next matching subsequence of the input.
This also updates the values for the start, end, and group methods.

Returns:

true if there is a matching subsequence.

end

public int end()
        throws java.lang.IllegalStateException

Returns the offset after the last character matched.

Specified by:

end in interface java.util.regex.MatchResult

Returns:

The offset after the last character matched.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

end

public int end(int group)
        throws java.lang.IndexOutOfBoundsException,
               java.lang.IllegalStateException

Returns the offset after the last character matched of the specified capturing group.
Note that because the automaton does not support capturing groups the only valid group is 0 (the entire match).

Specified by:

end in interface java.util.regex.MatchResult

Parameters:

group - the desired capturing group.

Returns:

The offset after the last character matched of the specified capturing group.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

java.lang.IndexOutOfBoundsException - if the specified capturing group does not exist in the underlying automaton.

group

public java.lang.String group()
                       throws java.lang.IllegalStateException

Returns the subsequence of the input found by the previous match.

Specified by:

group in interface java.util.regex.MatchResult

Returns:

The subsequence of the input found by the previous match.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

group

public java.lang.String group(int group)
                       throws java.lang.IndexOutOfBoundsException,
                              java.lang.IllegalStateException

Returns the subsequence of the input found by the specified capturing group during the previous match operation.
Note that because the automaton does not support capturing groups the only valid group is 0 (the entire match).

Specified by:

group in interface java.util.regex.MatchResult

Parameters:

group - the desired capturing group.

Returns:

The subsequence of the input found by the specified capturing group during the previous match operation the previous match. Or null if the given group did match.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

java.lang.IndexOutOfBoundsException - if the specified capturing group does not exist in the underlying automaton.

groupCount

public int groupCount()

Returns the number of capturing groups in the underlying automaton.
Note that because the automaton does not support capturing groups this method will always return 0.

Specified by:

groupCount in interface java.util.regex.MatchResult

Returns:

The number of capturing groups in the underlying automaton.

start

public int start()
          throws java.lang.IllegalStateException

Returns the offset of the first character matched.

Specified by:

start in interface java.util.regex.MatchResult

Returns:

The offset of the first character matched.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

start

public int start(int group)
          throws java.lang.IndexOutOfBoundsException,
                 java.lang.IllegalStateException

Returns the offset of the first character matched of the specified capturing group.
Note that because the automaton does not support capturing groups the only valid group is 0 (the entire match).

Specified by:

start in interface java.util.regex.MatchResult

Parameters:

group - the desired capturing group.

Returns:

The offset of the first character matched of the specified capturing group.

Throws:

java.lang.IllegalStateException - if there has not been a match attempt or if the last attempt yielded no results.

java.lang.IndexOutOfBoundsException - if the specified capturing group does not exist in the underlying automaton.

toMatchResult

public java.util.regex.MatchResult toMatchResult()

Returns the current state of this AutomatonMatcher as a MatchResult. The result is unaffected by subsequent operations on this object.

Returns:

a MatchResult with the state of this AutomatonMatcher.