org.apache.tools.ant.taskdefs.condition
Class Matches

java.lang.Object
  extended by org.apache.tools.ant.ProjectComponent
      extended by org.apache.tools.ant.taskdefs.condition.Matches
All Implemented Interfaces:
java.lang.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
Matches()
           
 
Method Summary
 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(java.lang.String pattern)
          Set the regular expression to match against
 void setSingleLine(boolean b)
          Whether to treat input as singleline ('.' matches newline).
 void setString(java.lang.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 Detail

Matches

public Matches()
Method Detail

setString

public void setString(java.lang.String string)
Set the string

Parameters:
string - the string to match

setPattern

public void setPattern(java.lang.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). Corresponsds 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