C.81 ReplaceRegexpTask

C.81 ReplaceRegexpTask
Prev	Appendix C. Optional tasks	Next

Replaces the occurrences of a given regular expression with a substitution pattern in a selected file or set of files.

Table C.107:

Name	Type	Description	Default	Required
`file`	`String`	File to apply regular expression on	n/a	Yes (or `fileset`)
`match`	`String`	Regular expression match pattern	n/a	Yes (or `pattern`)
`pattern`	`String`	Regular expression match pattern	n/a	Yes
`replace`	`String`	The replacement string	n/a	Yes

C.81.1 Supported Nested Tags

fileset

1 PropertySelector

Selects property names that match a given regular expression and returns them in a delimited list

Table C.108: Attributes

Name	Type	Description	Default	Required
`property`	`String`	The name of the property to set.	n/a	Yes
`override`	`Boolean`	If the property is already set, should we change it's value. Can be `true` or `false`	false	No
`match`	`String`	The regular expression which is used to select property names for inclusion in the list. This follows the standard regular expression syntax accepted by phing's regular expression tasks.	n/a	Yes
`select`	`String`	A pattern which indicates what selection pattern you want in the returned list. This used the substitution pattern syntax to indicate where to insert groupings created as a result of the regular expression match.	\0	No
`casesensitive`	`String`	Should the match be case sensitive.	true	No
`replace`	`String`	A regular expression substitition pattern, which will be used to replace the given regular expression in the subject.	n/a	Yes (unless a match is specified)
`casesensitive`	`Boolean`	Should the match be case sensitive	true	No
`delimiter`	`String`	The delimiter used to separate entries in the resulting property	,	No
`distinct`	`Boolean`	Should the returned entries be a distinct set (no duplicate entries).	false	No

1.1 Select expressions

Expressions are matched in a the same syntax as a regular expression substitution pattern.

$0 indicates the entire property name (default).
$1 indicates the first grouping
$2 indicates the second grouping
etc...

1.2 Example

<property name="package.ABC.name" value="abc pack name" />
                    <property name="package.DEF.name" value="def pack name" />
                    <property name="package.GHI.name" value="ghi pack name" />
                    <property name="package.JKL.name" value="jkl pack name" />

                    <propertyselector property="pack.list"
                                      delimiter=","
                                      match="package\.([^\.]*)\.name"
                                      select="\1"
                                      casesensitive="false" />

Prev	Up	Next
C.80 PropertyRegexTask	Home	2 URLEncodeTask