diff options
Diffstat (limited to 'docs/manual/tasks/sortlist.html')
| -rw-r--r-- | docs/manual/tasks/sortlist.html | 145 |
1 files changed, 0 insertions, 145 deletions
diff --git a/docs/manual/tasks/sortlist.html b/docs/manual/tasks/sortlist.html deleted file mode 100644 index 5af5d41..0000000 --- a/docs/manual/tasks/sortlist.html +++ /dev/null @@ -1,145 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> - <head> - <title>Ant-contrib Tasks: SortList</title> - </head> - - <body> - <h1>SortList</h1> - - <p>Sort a delimited list of items in their natural string order. Note that - the <code>value</code> and <code>refid</code> attributes are mutually exclusive, - and the <code>value</code> attribute takes precedence if both are specified.</p> - - <h2>Parameters</h2> - <table border="1" cellpadding="2" cellspacing="0"> - <tr> - <th>Attribute</th> - <th>Description</th> - <th>Required</th> - </tr> - <tr> - <td valign="top">property</td> - <td valign="top">The name of the property to set.</td> - <td align="center" valign="top">Yes.</td> - </tr> - <tr> - <td valign="top">override</td> - <td valign="top">If the property is already set, should we change it's value. - Can be <code>true</code> or <code>false</code></td> - <td align="center" valign="top">No. Defaults to <code>false</code></td> - </tr> - <tr> - <td valign="top">value</td> - <td valign="top">The list of values to process, with the - delimiter character, indicated by the "delimiter" - attribute, separating each value.</td> - <td align="center" valign="top">Yes, unless "refid" is - specified.</td> - </tr> - <tr> - <td valign="top">refid</td> - <td valign="top">The id of where the list of values to sort is - stored.</td> - <td align="center" valign="top">Yes, unless "value" is - specified.</td> - </tr> - <tr> - <td valign="top">delimiter</td> - <td valign="top">The delimiter string that separates the - values in the "list" attribute.</td> - <td align="center" valign="top">No, defaults to ",".</td> - </tr> - <tr> - <td valign="top">casesensitive</td> - <td valign="top">If <code>true</code>, does a case sensitive sorting - of the strings. If <code>false</code> does case insensitive sorting. - </td> - <td align="center" valign="top">No. Defaults to true.</td> - </tr> - <tr> - <td valign="top">numeric</td> - <td valign="top">If <code>true</code>, does a numeric sorting, treating - all list entries as if they were numbers. - </td> - <td align="center" valign="top">No. Defaults to false.</td> - </tr> - - <tr> - <td valign="top">orderPropertyFile</td> - <td valign="top">If specified, the list will sorted as if they were property - names, and will be sorted in the order those properties appear - in the given property file. Any properties in the - <code>value</code> attribute which do not appear in the properties file - will be inserted at the end of the list. This property is most useful - when used in conjunction with the <code><propertyselector></code> - task (see Example 2). - </td> - <td align="center" valign="top">No.</td> - </tr> - - <tr> - <td valign="top">orderPropertyFilePrefix</td> - <td valign="top">If <code>orderPropertyFile</code> is specified, this - value (with a trailing '.') will be prefixed to each property in the - specified <code>orderPropertyFile</code> to determine sorting order - </td> - <td align="center" valign="top">No.</td> - </tr> - - </table> - - <hr /> - - <h2>Example 1</h2> - <pre> - <code> - <property name="my.list" value="z,y,x,w,v,u,t" /> - <sortlist property="my.sorted.list" value="${my.list}" - delimiter="," /> - <echo message="${my.sorted.list}" /> - </code> - - prints - - <code> - [echo] t,u,v,w,x,y,z - </code> - - <h2>Example 2</h2> - <pre> - test.properties - --------------- - a.name=a - c.name=c - b.name=b - - <code> - <property file="test.properties" prefix="test" /> - <propertyselector property="my.list" - delimiter="," - match="test\..*\.name" - select="\0" /> - <sortlist property="my.sorted.list" - value="${my.list}" - delimiter="," - orderPropertyFile="test.properties" - orderPropertyFilePrefix="test" /> - - <echo message="${my.sorted.list}" /> - - prints - - <code> - [echo] test.a.name,test.c.name,test.b.name - </code> - - Notice that the <code>test.properties</code> file did not have "test." - prefixing all the properties. The <code>orderPropertyFilePrefix</code> was - used to do that. - <hr> - <p align="center">Copyright © 2002-2003 Ant-Contrib Project. All - rights Reserved.</p> - - </body> -</html> |