Package org.apache.tools.ant.taskdefs.condition

# Class Matches

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.taskdefs.condition.Matches

All Implemented Interfaces:
  `Cloneable`, `Condition`

public class Matches extends ProjectComponent implements Condition
Simple regular expression condition.

Since:
  Ant 1.7

## Field Summary

### Fields inherited from class org.apache.tools.ant.ProjectComponent

`description, location, project`

## Constructor Summary

Constructors
Constructor
Description
`Matches()`

## Method Summary

Modifier and Type
Method
Description
`void`
`addRegexp(RegularExpression regularExpression)`
A regular expression.
`boolean`
`eval()`
Is this condition true?
`void`
`setCasesensitive(boolean b)`
Whether to ignore case or not.
`void`
`setMultiline(boolean b)`
Whether to match should be multiline.
`void`
`setPattern(String pattern)`
Set the regular expression to match against
`void`
`setSingleLine(boolean b)`
Whether to treat input as singleline ('.' matches newline).
`void`
`setString(String string)`
Set the string

### Methods inherited from class org.apache.tools.ant.ProjectComponent

`clone, getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject`

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

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

## Constructor Details

### Matches

public Matches()

## Method Details

### setString

public void setString(String string)
Set the string

Parameters:
  `string` - the string to match

### setPattern

public void setPattern(String pattern)
Set the regular expression to match against

Parameters:
  `pattern` - the regular expression pattern

### addRegexp

public void addRegexp(RegularExpression regularExpression)
A regular expression. You can use this element to refer to a previously defined regular expression datatype instance

Parameters:
  `regularExpression` - the regular expression object to be configured as an element

### setCasesensitive

public void setCasesensitive(boolean b)
Whether to ignore case or not.

Parameters:
  `b` - if false, ignore case.
Since:
  Ant 1.7

### setMultiline

public void setMultiline(boolean b)
Whether to match should be multiline.

Parameters:
  `b` - the value to set.

### setSingleLine

public void setSingleLine(boolean b)
Whether to treat input as singleline ('.' matches newline). Corresponds to java.util.regex.Pattern.DOTALL.

Parameters:
  `b` - the value to set.

### eval

public boolean eval() throws BuildException
Description copied from interface: `Condition`
Is this condition true?

Specified by:
  `eval` in interface `Condition`
Returns:
  true if the string matches the regular expression pattern
Throws:
  `BuildException` - if the attributes are not set correctly