<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>Ant-contrib Tasks: TimestampSelector</title> </head> <body> <h1>TimestampSelector</h1> <p>The TimestampSelector task takes either a nested <path> element, or a path reference, and sets either a named property, or a <code>path</code> instance to absolute pathnames of the files with either the N latest or earliest modification dates (based on the <code>age</code> attribute)</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 property to set with the most recently modified file. Mutually exclusive with the <code>outputsetid</code> attribute.</td> <td align="center" valign="top">Yes, if <code>outputsetid</code> is not specified.</td> </tr> <tr> <td valign="top">outputsetid</td> <td valign="top">The id of a <code>path</code> instance which will contain the resulting list of files. This id should not already exist. Mutually exclusive with the <code>property</code> attribute</td> <td align="center" valign="top">Yes, if <code>property</code> is note specified.</td> </tr> <tr> <td valign="top">count</td> <td valign="top">The number of files to find. If more than 1, than the files in the output appear in the order indicated by the <code>age</code> attribute.</td> <td align="center" valign="top">No. Defaults to <code>1<code></td> </tr> <tr> <td valign="top">age</td> <td valign="top">The age of the files to retrieve, either <code>eldest</code> or <code>youngest</code>. Defaults to <code>youngest</code>.</td> <td align="center" valign="top">No. Defaults to <code>1<code></td> </tr> <tr> <td valign="top">pathSep</td> <td valign="top">The path separator to separate paths with when using the <code>property</code> attribute in conjunction with the <code>count</code> attribute</td> <td align="center" valign="top">No. Defaults to <code>,<code></td> </tr> <tr> <td valign="top">pathref</td> <td valign="top">Id of the path to find the most recently modified file in.</td> <td align="center" valign="top">No, if a <code>path</code> subelement is specified.</td> </tr> </table> <h2>Parameters specified as nested elements</h2> <a name="path"><h3>path</h3></a> <p><a href="http://ant.apache.org/manual/using.html#path">Path</a> is used to select sets of files or directories in which to find the most recently modified file</p> <h2>Example</h2> <h3>Using a path reference</h3> <pre> <code> <path id="mypath"> <fileset dir="${log.dir}"> <include name="update*.log" /> </fileset> <path> <timestampselector property="most.recent.logs" pathref="mypath" count="3" pathsep=";" /> <echo message="${most.recent.logs}" /> </code> </pre> <h3>Using a nested <code>path</code> element</h3> <pre> <code> <timestampselector property="most.recent.logs" count="3" pathsep=";" > <path> <fileset dir="${log.dir}"> <include name="update*.log" /> </fileset> <path> </timestampselector> <echo message="${most.recent.logs}" /> </code> </pre> <h3>Outputing to a <code>path</code> element</h3> <pre> <code> <timestampselector outputsetref="most.recent.logs" pathref="mypath" count="3"> <path> <fileset dir="${log.dir}"> <include name="update*.log" /> </fileset> <path> </timestampselector> <copy todir="somedir"> <path refid="most.recent.logs" /> </copy> </code> </pre> <hr> <p align="center">Copyright © 2002-2003 Ant-Contrib Project. All rights Reserved.</p> </body> </html>