Matches (Apache Ant API)
Date: 2015-06-29

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:
    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

    Constructors
    Constructor and Description
    `Matches()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and 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(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). 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