org.apache.tools.ant.util.regexp

Interface RegexpMatcher

Known Subinterfaces:
Regexp
Known Implementing Classes:
JakartaOroMatcher, JakartaOroRegexp, JakartaRegexpMatcher, JakartaRegexpRegexp, Jdk14RegexpMatcher, Jdk14RegexpRegexp

public interface RegexpMatcher

Interface describing a regular expression matcher.

Field Summary

static int
MATCH_CASE_INSENSITIVE
Perform a case insenstive match
static int
MATCH_DEFAULT
Default Mask (case insensitive, neither multiline nor singleline specified).
static int
MATCH_MULTILINE
Treat the input as a multiline input
static int
MATCH_SINGLELINE
Treat the input as singleline input ('.' matches newline)

Method Summary

Vector
getGroups(String argument)
Returns a Vector of matched groups found in the argument.
Vector
getGroups(String input, int options)
Get the match groups from this regular expression.
String
getPattern()
Get a String representation of the regexp pattern
boolean
matches(String argument)
Does the given argument match the pattern?
boolean
matches(String input, int options)
Does this regular expression match the input, given certain options
void
setPattern(String pattern)
Set the regexp pattern from the String description.

Field Details

MATCH_CASE_INSENSITIVE

public static final int MATCH_CASE_INSENSITIVE
Perform a case insenstive match

Field Value:
256


MATCH_DEFAULT

public static final int MATCH_DEFAULT
Default Mask (case insensitive, neither multiline nor singleline specified).

Field Value:
0


MATCH_MULTILINE

public static final int MATCH_MULTILINE
Treat the input as a multiline input

Field Value:
4096


MATCH_SINGLELINE

public static final int MATCH_SINGLELINE
Treat the input as singleline input ('.' matches newline)

Field Value:
65536

Method Details

getGroups

public Vector getGroups(String argument)
            throws BuildException
Returns a Vector of matched groups found in the argument.

Group 0 will be the full match, the rest are the parenthesized subexpressions.


getGroups

public Vector getGroups(String input,
                        int options)
            throws BuildException
Get the match groups from this regular expression. The return type of the elements is always String.

Parameters:
input - The string to check for a match
options - The list of options for the match. See the MATCH_ constants above.


getPattern

public String getPattern()
            throws BuildException
Get a String representation of the regexp pattern


matches

public boolean matches(String argument)
            throws BuildException
Does the given argument match the pattern?


matches

public boolean matches(String input,
                       int options)
            throws BuildException
Does this regular expression match the input, given certain options

Parameters:
input - The string to check for a match
options - The list of options for the match. See the MATCH_ constants above.


setPattern

public void setPattern(String pattern)
            throws BuildException
Set the regexp pattern from the String description.


Copyright B) 2000-2005 Apache Software Foundation. All Rights Reserved.