| <html> |
| |
| <head> |
| <meta http-equiv="Content-Language" content="en-us"> |
| <title>PropertySet Type</title> |
| <link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css"> |
| </head> |
| |
| <body> |
| |
| <h2><a name="propertyset">PropertySet</a></h2> |
| <p><em>Since Ant 1.6</em></p> |
| |
| <p>Groups a set of properties to be used by reference in a task that |
| supports this.</p> |
| |
| <table border="1" cellpadding="2" cellspacing="0"> |
| <tr> |
| <td valign="top"><b>Attribute</b></td> |
| <td valign="top"><b>Description</b></td> |
| <td align="center" valign="top"><b>Required</b></td> |
| </tr> |
| <tr> |
| <td valign="top">dynamic</td> |
| <td valign="top">Whether to reevaluate the set everytime the set |
| is used. Default is "<code>true</code>".</td> |
| <td valign="top" align="center">No</td> |
| </tr> |
| </table> |
| <h3>Parameters specified as nested elements</h3> |
| |
| <h4>propertyref</h4> |
| |
| <p>Selects properties from the current project to be included in the |
| set.</p> |
| |
| <table border="1" cellpadding="2" cellspacing="0"> |
| <tr> |
| <td valign="top"><b>Attribute</b></td> |
| <td valign="top"><b>Description</b></td> |
| <td align="center" valign="top"><b>Required</b></td> |
| </tr> |
| <tr> |
| <td valign="top">name</td> |
| <td valign="top">Select the property with the given name.</td> |
| <td align="center" valign="top" rowspan="4">Exactly one of these.</td> |
| </tr> |
| <tr> |
| <td valign="top">prefix</td> |
| <td valign="top">Select the properties whose name starts with the |
| given string.</td> |
| </tr> |
| <tr> |
| <td valign="top">regexp</td> |
| <td valign="top">Select the properties that match the given |
| regular expression. Similar to <a |
| href="mapper.html#regexp-mapper">regexp type mappers</a>, this |
| equires a supported regular expression library.</td> |
| </tr> |
| <tr> |
| <td valign="top">builtin</td> |
| <td valign="top">Selects a builtin set of properties. Valid |
| values for this attribute are <code>all</code> for all Ant |
| properties, <code>system</code> for the system properties and |
| <code>commandline</code> for all properties specified on the |
| command line when invoking Ant (plus a number of special |
| internal Ant properties).</td> |
| </tr> |
| </table> |
| |
| <h4>propertyset</h4> |
| |
| <p>A <code>propertyset</code> can be used as the set union of more |
| <code>propertyset</code>s.</p> |
| |
| <p>For example:</p> |
| |
| <blockquote><pre> |
| <propertyset id="properties-starting-with-foo"> |
| <propertyref prefix="foo"/> |
| </propertyset> |
| <propertyset id="properties-starting-with-bar"> |
| <propertyref prefix="bar"/> |
| </propertyset> |
| <propertyset id="my-set"> |
| <propertyset refid="properties-starting-with-foo"/> |
| <propertyset refid="properties-starting-with-bar"/> |
| </propertyset> |
| </pre></blockquote> |
| |
| <p>collects all properties whose name starts with either |
| "foo" or "bar" in the set named |
| "my-set".</p> |
| |
| <h4>mapper</h4> |
| |
| <p>A <a href="mapper.html">mapper</a> - at maximum one mapper can be |
| specified. The mapper is used to change the names of the property |
| keys, for example: |
| |
| <blockquote><pre> |
| <propertyset id="properties-starting-with-foo"> |
| <propertyref prefix="foo"/> |
| <mapper type="glob" from="foo*" to="bar*"/> |
| </propertyset> |
| </pre></blockquote> |
| |
| <p>collects all properties whose name starts with "foo", but |
| changes the names to start with "bar" instead.</p> |
| |
| <hr> |
| <p align="center">Copyright © 2003 Apache Software Foundation. All rights |
| Reserved.</p> |
| |
| </body> |
| </html> |
| |
