org.apache.tools.ant.util.regexp

## Class JakartaOroMatcher

- java.lang.Object
- - org.apache.tools.ant.util.regexp.JakartaOroMatcher

All Implemented Interfaces:
  RegexpMatcher

Direct Known Subclasses:
  JakartaOroRegexp

    public class JakartaOroMatcher
    extends java.lang.Object
    implements RegexpMatcher

Implementation of RegexpMatcher for Jakarta-ORO.

### Field Summary

Fields
`protected org.apache.oro.text.regex.Perl5Compiler` `compiler`
`protected org.apache.oro.text.regex.Perl5Matcher` `matcher`

### Fields inherited from interface org.apache.tools.ant.util.regexp.RegexpMatcher

`MATCH_CASE_INSENSITIVE, MATCH_DEFAULT, MATCH_MULTILINE, MATCH_SINGLELINE`

### Constructor Summary

Constructors
Constructor and Description
`JakartaOroMatcher()` Constructor for JakartaOroMatcher.

### Method Summary

Methods
`protected org.apache.oro.text.regex.Pattern` `getCompiledPattern(int options)` Get a compiled representation of the regexp pattern
`protected int` `getCompilerOptions(int options)` Convert the generic options to the regex compiler specific options.
`java.util.Vector` `getGroups(java.lang.String argument)` Returns a Vector of matched groups found in the argument using default options.
`java.util.Vector` `getGroups(java.lang.String input, int options)` Returns a Vector of matched groups found in the argument.
`java.lang.String` `getPattern()` Get a String representation of the regexp pattern
`boolean` `matches(java.lang.String argument)` Does the given argument match the pattern using default options?
`boolean` `matches(java.lang.String input, int options)` Does the given argument match the pattern?
`void` `setPattern(java.lang.String pattern)` Set the regexp pattern from the String description.

### Methods inherited from class java.lang.Object

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

### Field Detail

#### compiler

    protected final org.apache.oro.text.regex.Perl5Compiler compiler

#### matcher

    protected final org.apache.oro.text.regex.Perl5Matcher matcher

### Constructor Detail

#### JakartaOroMatcher

    public JakartaOroMatcher()

Constructor for JakartaOroMatcher.

### Method Detail

#### setPattern

    public void setPattern(java.lang.String pattern)

Set the regexp pattern from the String description.

Specified by:
  `setPattern` in interface `RegexpMatcher`
Parameters:
  `pattern` - the pattern to match

#### getPattern

    public java.lang.String getPattern()

Get a String representation of the regexp pattern

Specified by:
  `getPattern` in interface `RegexpMatcher`
Returns:
  the pattern

#### getCompiledPattern

    protected org.apache.oro.text.regex.Pattern getCompiledPattern(int options)
                                                            throws BuildException

Get a compiled representation of the regexp pattern

Parameters:
  `options` - the options
Returns:
  the compiled pattern
Throws:
  `BuildException` - on error

#### matches

    public boolean matches(java.lang.String argument)
                    throws BuildException

Does the given argument match the pattern using default options?

Specified by:
  `matches` in interface `RegexpMatcher`
Parameters:
  `argument` - the string to match against
Returns:
  true if the pattern matches
Throws:
  `BuildException` - on error

#### matches

    public boolean matches(java.lang.String input,
                  int options)
                    throws BuildException

Does the given argument match the pattern?

Specified by:
  `matches` in interface `RegexpMatcher`
Parameters:
  `input` - the string to match against
  `options` - the regex options to use
Returns:
  true if the pattern matches
Throws:
  `BuildException` - on error

#### getGroups

    public java.util.Vector getGroups(java.lang.String argument)
                               throws BuildException

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

.

Specified by:
  `getGroups` in interface `RegexpMatcher`
Parameters:
  `argument` - the string to match against
Returns:
  the vector of groups
Throws:
  `BuildException` - on error

#### getGroups

    public java.util.Vector getGroups(java.lang.String input,
                             int options)
                               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

.

Specified by:
  `getGroups` in interface `RegexpMatcher`
Parameters:
  `input` - the string to match against
  `options` - the regex options to use
Returns:
  the vector of groups
Throws:
  `BuildException` - on error

#### getCompilerOptions

    protected int getCompilerOptions(int options)

Convert the generic options to the regex compiler specific options.

Parameters:
  `options` - the generic options
Returns:
  the specific options