com.izforge.izpack.util.regex

Interface RegexpMatcher

All Known Subinterfaces:

Regexp

All Known Implementing Classes:

JavaRegexp, JavaRegexpMatcher

public interface RegexpMatcher

Interface describing a regular expression matcher.

Author:

René Krell - changes against the original implementation in Apache Ant 1.6.5

See Also:

Apache Ant

Field Summary

Fields

Modifier and Type	Field and Description
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

Modifier and Type	Method and Description
Vector<String>	getGroups(String argument) Returns a Vector of matched groups found in the argument using default options.
Vector<String>	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 Detail

MATCH_DEFAULT

static final int MATCH_DEFAULT

Default Mask (case insensitive, neither multiline nor singleline specified).

See Also:

Constant Field Values

MATCH_CASE_INSENSITIVE

static final int MATCH_CASE_INSENSITIVE

Perform a case insenstive match

See Also:

Constant Field Values

MATCH_MULTILINE

static final int MATCH_MULTILINE

Treat the input as a multiline input

See Also:

Constant Field Values

MATCH_SINGLELINE

static final int MATCH_SINGLELINE

Treat the input as singleline input ('.' matches newline)

See Also:

Constant Field Values

Method Detail

setPattern

void setPattern(String pattern)
         throws RuntimeException

Set the regexp pattern from the String description.

Parameters:

pattern - the pattern to match

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException

getPattern

String getPattern()
           throws RuntimeException

Get a String representation of the regexp pattern

Returns:

the pattern

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException

matches

boolean matches(String argument)
         throws RuntimeException

Does the given argument match the pattern?

Parameters:

argument - the string to match against

Returns:

true if the pattern matches

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException

getGroups

Vector<String> getGroups(String argument)
                  throws RuntimeException

Returns a Vector of matched groups found in the argument using default options.

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

.

Parameters:

argument - the string to match against

Returns:

the vector of groups

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException

matches

boolean matches(String input,
                int options)
         throws RuntimeException

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.

Returns:

true if the pattern matches

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException

getGroups

Vector<String> getGroups(String input,
                         int options)
                  throws RuntimeException

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.

Returns:

the vector of groups

Throws:

org.apache.tools.ant.BuildException - on error

RuntimeException