F.10 RegexpMapper

F.10 RegexpMapper
Prev	Appendix F. Core mappers	Next

The RegexpMapper changes filenames according to a pattern defined by a regular expression. This is the most powerful mapper and you should be able to use it for every possible application.

Table F.10: The regexp mapper can take the following extra attributes.

Name	Type	Description	Default	Required
`handledirsep`	`String`	If this is specified, the mapper will ignore the difference between the normal directory separator characters - \ and /. This attribute is useful for cross-platform build files.	false	No
`casesensitive`	`Boolean`	If this is false, the mapper will ignore case when matching the glob pattern.	true	No

F.10.1 Examples

<mapper type="regexp" from="^(.*)\.conf\.xml" to="\1.php"/>

The mapper as above will do the following mappings:

Table F.11: Result of mapping

From	To
`test.txt`	ignore, `test.txt`
`./foo/bar/test.conf.xml`	`./foo/bar/test.php`
`someconf.conf.xml`	`someconf.php`

Prev	Up	Next
F.9 MergeMapper	Home	Appendix G. Core selectors