/usr/share/doc/libantelope-java/manual/bk03ch22.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 22. Grep Task</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Antelope Users Guide"><link rel="up" href="bk03.html" title="Additional Ant Tasks"><link rel="prev" href="bk03ch21.html" title="Chapter 21. Call Task"><link rel="next" href="bk03ch23.html" title="Chapter 23. Split Task"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 22. Grep Task</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk03ch21.html">Prev</a> </td><th width="60%" align="center">Additional Ant Tasks</th><td width="20%" align="right"> <a accesskey="n" href="bk03ch23.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 22. Grep Task"><div class="titlepage"><div><div><h2 class="title"><a name="greptask"></a>Chapter 22. Grep Task</h2></div></div></div>
@style@
    <p>
This task uses a regular expression to do pattern matching against a string and store the match in a property.  This is useful for extracting a substring, or checking that an html form contains a particular value.</p><p>
To use this task in your build files, include a task definition like this:
</p><pre class="programlisting">

    &lt;taskdef name="grep" classname="ise.antelope.tasks.Find"/&gt;
   
</pre><p>
</p><p>
</p><div class="table"><a name="id2520790"></a><p class="title"><b>Table 22.1. Grep Task Attributes</b></p><div class="table-contents"><table summary="Grep Task Attributes" border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Attribute</th><th>Description</th><th>Default</th><th>Required</th></tr></thead><tbody><tr><td>in</td><td>The string to perform the regular expression matching on</td><td>None</td><td>Yes</td></tr><tr><td>regex</td><td>The regular expression.  See the Java API documentation for java.util.regex.Pattern for the details of the syntax for this expression.</td><td>None</td><td>Yes</td></tr><tr><td>group</td><td>The regular expression group to return in the property.</td><td>0</td><td>No</td></tr><tr><td>property</td><td>The name of a property in which to put the matched value.</td><td>None</td><td>Yes</td></tr><tr><td>allmatches</td><td>A regex may find multiple matches in the input string.  If this attribute is set to true, then the property set after the grep will contain all matches.  The individual matches can be separated by using the 'separator' attribute (see below). The default is 'false', that is, only return the first match.</td><td>false</td><td>No</td></tr><tr><td>separator</td><td>When 'allmatches' is set to true and there are multiple matches, this value will be used to separate the individual matches.</td><td>${line.separator}</td><td>No</td></tr><tr><td>caseinsensitive</td><td>Enables case-insensitive matching.</td><td>false</td><td>No</td></tr><tr><td>comments</td><td>Permits whitespace and comments in pattern.</td><td>false</td><td>No</td></tr><tr><td>dotall</td><td>Enables dotall mode.</td><td>false</td><td>No</td></tr><tr><td>multiline</td><td>Enables multiline mode.</td><td>false</td><td>No</td></tr><tr><td>unicodecase</td><td>Enables Unicode-aware case folding.</td><td>false</td><td>No</td></tr><tr><td>canoneq</td><td>Enables canonical equivalence.</td><td>false</td><td>No</td></tr><tr><td>unixlines</td><td>Enables Unix lines mode.</td><td>false</td><td>No</td></tr></tbody></table></div></div><p><br class="table-break">
</p><p>
Examples:
</p><p>
</p><pre class="programlisting">

 &lt;target name="test" description="Test grep"&gt;
      &lt;grep in="${response}" regex="(account id=)([0-9]+)" group="2" property="AccountId"/&gt;
      &lt;echo&gt;Account Id: ${AccountId} received for ${user}&lt;/echo&gt;
 &lt;/target&gt;

</pre><p>
</p><p>
This example uses the 'unset' and 'post' tasks along with 'grep' to list the download url's for Ant:
</p><pre class="programlisting">


    &lt;target name="test"&gt;
      &lt;unset name="ant_download_page"/&gt;
      &lt;post to="http://ant.apache.org/bindownload.cgi"
            verbose="no"
            property="ant_download_page"/&gt;
      &lt;grep in="${ant_download_page}"
            regex="select name=&amp;quot;Preferred.*?&amp;lt;/select"
            dotall="yes"
            property="options"/&gt;

      &lt;unset name="urls"/&gt;
      &lt;grep in="${options}"
         regex="&amp;lt;option.*?&amp;gt;(.*?)&amp;lt;/option&amp;gt;"
         group="1"
         allmatches="yes"
         separator="${line.separator}"
         property="urls"/&gt;
      &lt;echo&gt;${urls}&lt;/echo&gt;
    &lt;/target&gt;

     [echo] http://apache.gr-linux.com
     [echo] http://www.reverse.net/pub/apache
     [echo] http://government-grants.org/mirrors/apache.org
     [echo] http://apache.mirrors.hoobly.com
     [echo] http://apache.mirrormax.net
     [echo] http://www.ibiblio.org/pub/mirrors/apache
     [echo] http://www.mirrormonster.com/apache.org
     [echo] http://apache.towardex.com
     [echo] http://www.axint.net/apache
     [echo] http://apache.tradebit.com/pub
     [echo] http://www.eng.lsu.edu/mirrors/apache
     [echo] http://mirrors.isc.org/pub/apache
     [echo] http://www.theshell.com/pub/apache
     [echo] http://apache.mirrors.redwire.net
     [echo] http://apache.cs.utah.edu
     [echo] http://www.tux.org/pub/net/apache/dist
     [echo] http://linux.cs.lewisu.edu/apache
     [echo] http://apache.roweboat.net
     [echo] http://apache.secsup.org/dist
     [echo] http://www.signal42.com/mirrors/apache
     [echo] http://apache.mirror99.com
     [echo] http://mirrors.xtria.com/apache
     [echo] http://apache.downlod.in
     [echo] http://apache.mirrors.pair.com
     [echo] http://apache.seekmeup.com
     [echo] http://mirrors.combose.com/apache
     [echo] http://www.wmwweb.com/apache
     [echo] http://apache.intissite.com
     [echo] http://apache.oregonstate.edu
     [echo] http://apache.bestwebcover.com
     [echo] http://ftp.wayne.edu/apache
     [echo] http://mirrors.ccs.neu.edu/Apache/dist
     [echo] http://www.ip97.com/apache.org
     [echo] http://apache.mirrors.versehost.com
     [echo] http://mirrors.playboy.com/apache
     [echo] ftp://ftp.ccs.neu.edu/net/mirrors/Apache/dist
     [echo] ftp://apache.mirrors.pair.com
     [echo] ftp://apache.cs.utah.edu/pub/apache.org
     [echo] ftp://apache.mirrors.redwire.net/pub/apache
     [echo] ftp://ftp.oregonstate.edu/pub/apache
     [echo] ftp://ftp.wayne.edu/apache
     [echo] ftp://mirror.sg.depaul.edu/pub/apache
     [echo] ftp://www.ibiblio.org/pub/mirrors/apache
     [echo] ftp://ftp.tux.org/pub/net/apache/dist
     [echo] ftp://www.reverse.net/pub/apache
     [echo] ftp://apache.secsup.org/pub/apache/dist
     [echo] http://www.eu.apache.org/dist (backup)
     [echo] http://www.apache.org/dist (backup)

</pre><p>
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk03ch21.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bk03ch23.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 21. Call Task </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 23. Split Task</td></tr></table></div></body></html>
libantelope-java-doc 3.5.1-2 / usr / share / doc / libantelope-java / manual / bk03ch22.html
