RegexpPatternMapper (Apache Ant API)
Date: 2015-07-03

org.apache.tools.ant.util

## Class RegexpPatternMapper

- java.lang.Object
- - org.apache.tools.ant.util.RegexpPatternMapper

- All Implemented Interfaces:
    FileNameMapper

      public class RegexpPatternMapper
      extends java.lang.Object
      implements FileNameMapper

  Implementation of FileNameMapper that does regular expression replacements.

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `protected RegexpMatcher` | `reg`
    `protected java.lang.StringBuffer` | `result`
    `protected char[]` | `to`

  - ### Constructor Summary

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

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `java.lang.String[]` | `mapFileName(java.lang.String sourceFileName)` Returns null if the source file name doesn't match the "from" pattern, an one-element array containing the translated file otherwise.
    `protected java.lang.String` | `replaceReferences(java.lang.String source)` Replace all backreferences in the to pattern with the matched groups of the source.
    `void` | `setCaseSensitive(boolean caseSensitive)` Attribute specifying whether to ignore the case difference in the names.
    `void` | `setFrom(java.lang.String from)` Sets the "from" pattern.
    `void` | `setHandleDirSep(boolean handleDirSep)` Attribute specifying whether to ignore the difference between / and \ (the two common directory characters).
    `void` | `setTo(java.lang.String to)` Sets the "to" pattern.

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

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

- - ### Field Detail

    - #### reg

          protected RegexpMatcher reg

    - #### to

          protected char[] to

    - #### result

          protected java.lang.StringBuffer result

  - ### Constructor Detail

    - #### RegexpPatternMapper

          public RegexpPatternMapper()
                              throws BuildException

      Constructor for RegexpPatternMapper.
      Throws:
        `BuildException` - on error.

  - ### Method Detail

    - #### setHandleDirSep

          public void setHandleDirSep(boolean handleDirSep)

      Attribute specifying whether to ignore the difference between / and \ (the two common directory characters).
      Parameters:
        `handleDirSep` - a boolean, default is false.
      Since:
        Ant 1.6.3

    - #### setCaseSensitive

          public void setCaseSensitive(boolean caseSensitive)

      Attribute specifying whether to ignore the case difference in the names.
      Parameters:
        `caseSensitive` - a boolean, default is false.
      Since:
        Ant 1.6.3

    - #### setFrom

          public void setFrom(java.lang.String from)
                       throws BuildException

      Sets the "from" pattern. Required.
      Specified by:
        `setFrom` in interface `FileNameMapper`
      Parameters:
        `from` - the from pattern.
      Throws:
        `BuildException` - on error.

    - #### setTo

          public void setTo(java.lang.String to)

      Sets the "to" pattern. Required.
      Specified by:
        `setTo` in interface `FileNameMapper`
      Parameters:
        `to` - the to pattern.
      Throws:
        `BuildException` - on error.

    - #### mapFileName

          public java.lang.String[] mapFileName(java.lang.String sourceFileName)

      Returns null if the source file name doesn't match the "from" pattern, an one-element array containing the translated file otherwise.
      Specified by:
        `mapFileName` in interface `FileNameMapper`
      Parameters:
        `sourceFileName` - the source file name
      Returns:
        a one-element array containing the translated file or null if the to pattern did not match

    - #### replaceReferences

          protected java.lang.String replaceReferences(java.lang.String source)

      Replace all backreferences in the to pattern with the matched groups of the source.
      Parameters:
        `source` - the source file name.
      Returns:
        the translated file name.