<![CDATA[
<table cellspacing="0" cellpadding="0">
<tr height="150">
<td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td>
<td width="100%" rowspan="2" align="left" valign="center">
<table cellspacing="0" cellpadding="0">
<tr>
<td>
<table class="navigate_doc" width="100%" border="0" align="center">
<tr bgcolor="c6c6e0" align="center">
<th nowrap width="1%" height="32">P0166</th>
<th nowrap width="98%">StringArraySubset</th>
<th nowrap width="1%">8th November 2002</th>
</tr>
<tr>
<td align="left" colspan="3">
<p><b>Author:</b> James S. Perrin, MVC
<b>Version:</b> 1.1
<b>Path:</b> iac_proj/strarsub/</p>
<a href="../../misc.shtml" target="_top"><img src="../../../../img/misc.gif" width="42" height="30" border="0" alt="Miscellaneous"></a>
<a href="strarsub.shtml" target="_top">
<img src="../../../../img/doc_umac.gif" border="0"
width="30" height="30"
alt="User Macro Document - StringArraySubset"></a>
<a href="source/misc/strarsub/strarsub.tar.gz">
<img src="../../../../img/targz.gif"
border="0" width="52" height="30"
alt="Archive - strarsub.tar.gz"></a>
<a href="source/misc/strarsub/strarsub.tar.Z">
<img src="../../../../img/tarz.gif"
border="0" width="52" height="30"
alt="Archive - strarsub.tar.Z"></a>
<a href="source/misc/strarsub/strarsub.zip">
<img src="../../../../img/zip.gif"
border="0" width="52" height="30"
alt="Archive - strarsub.zip"></a>
<img src="../../../../img/7.1.gif" alt="Tested for AVS/Express Version 7.1" border="0" height="30" width="47">
<img src="../../../../img/64bit.gif" alt="Tested for 64 Bit" border="0" height="30" width="53">
</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td>
<!-- BEGIN CONTENT PAGE -->
<h1>string_array_subset</h1>
<h3>Synopsis</h3>
<p>
Provides prim[start:end] functionality for string arrays.
</p>
<p>
<h4>Inputs</h4>
<table class="parameters" width="100%" summary="Inputs used by string_array_subset">
<tr>
<td width="30%"><b>Name</b></td>
<td width="20%"><b>Type</b></td>
<td width="50%"><b>Description</b></td>
</tr>
<tr>
<td colspan="3"><hr width="100%"></td>
</tr>
<tr>
<td width="30%"><i>in</i></td>
<td width="20%">string []</td>
<td width="50%">array of strings </td>
</tr>
<tr>
<td width="30%"><i>start</i></td>
<td width="20%">int</td>
<td width="50%">start of string range</td>
</tr>
<tr>
<td width="30%"><i>end</i></td>
<td width="20%">int</td>
<td width="50%">end of string range</td>
</tr>
<tr>
<td colspan="3"><hr width="100%"></td>
</tr>
</table>
<h4>Output Ports</h4>
<table class="parameters" width="100%" summary="Outputs used by string_array_subset">
<tr>
<td width="30%"><b>Name</b></td>
<td width="20%"><b>Type</b></td>
<td width="50%"><b>Description</b></td>
</tr>
<tr>
<td colspan="3"><hr width="100%"></td>
</tr>
<tr>
<td width="30%"><i>out</i></td>
<td width="20%">string []</td>
<td width="50%">subset of array <i>in</i></td>
</tr>
<tr>
<td colspan="3"><hr width="100%"></td>
</tr>
</table>
</p>
<h3>Description</h3>
<p>
The useful subset syntax <tt>[start:end]</tt> is only implimented for prims, in fact Express tells you that it's "not currently" implimented for strings. This module does exactly that.
</p>
<h3>Parameters</h3>
<h4>Inputs</h4>
<p><b><i>in</i></b></p>
<p>An array of strings.</p>
<p><b><i>start</i></b></p>
<p>Using 0 indexing the start of the subset you want to extract.</p>
<p><b><i>end</i></b></p>
<p>Using 0 indexing the end of the subset you want to extract.</p>
<h4>Outputs</h4>
<p><b><i>out</i></b></p>
<p>The string array equivalent to <tt>in[start:end].</tt></p>
<h3>Example</h3>
<p>
The Macro returns a subset of the input array of strings:
<p>
<h4> Input: </h4>
<pre>
in[6] = {"text0","text1","text2","text3","text4","text5"}
start = 2
end = 4
</pre>
<h4> Output: </h4>
<pre>
out[3] = {"text2","text3","text4"}
</pre>
</p>
<h3>Files</h3>
<p><i>iac_proj/strarsub/strarsub.v</i> defines the library</p>
<p><i>iac_proj/strarsub/sas_mods.v</i> module definition</p>
<h3>Author</h3>
<p>
<pre>
James S. Perrin,
Manchester Visualization Centre
</pre>
</p>
<h3>Contact</h3>
<p>
<pre>
International AVS Centre
Manchester Visualization Centre
Kilburn Building
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL
</pre>
</p>
<h3>See Also</h3>
<p>
AVS/Express documentation for prim arrays.
</p>
<!-- END CONTENT PAGE -->
</td>
</tr>
</table>
</td>
</tr>
<tr height="100%">
<td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap">
<p><a href="../../../../general/index.shtml" target="_top">General Information</a></p>
<p><a href="../../../../repository/index.shtml" target="_top">Repositories</a></p>
<p class="sideLinkLevel2"><a href="../../../new/index.shtml" target="_top"> New Releases</a></p>
<p class="sideLinkLevel2"><a href="../../../download/index.shtml" target="_top"> Download</a></p>
<p class="sideLinkLevel2"><a href="../../../submit/index.shtml" target="_top"> Submit</a></p>
<p class="sideLinkLevel2"><a href="../../../pfiles/index.shtml" target="_top"> Project Files</a></p>
<p class="sideLinkLevel2"><a href="../../../avs5/index.shtml" target="_top"> AVS5</a></p>
<p class="sideLinkLevel2"><a href="../../../express/index.shtml" target="_top"> AVS/Express</a></p>
<p class="sideLinkLevel3"><a href="../../atoz.shtml" target="_top"> A to Z</a></p>
<p class="sideLinkLevel3"><a href="../../number.shtml" target="_top"> Project #</a></p>
<p></p>
<p class="sideLinkLevel3"><a href="../../data_io.shtml" target="_top"> Data IO</a></p>
<p class="sideLinkLevel3"><a href="../../filters.shtml" target="_top"> Filters</a></p>
<p class="sideLinkLevel3"><a href="../../mappers.shtml" target="_top"> Mappers</a></p>
<p class="sideLinkLevel3"><a href="../../misc.shtml" target="_top"> Miscellaneous</a></p>
<p class="sideLinkLevel3"><a href="../../special.shtml" target="_top"> Special Projects</a></p>
<p class="sideLinkLevel2"><a href="../../../pog/index.shtml" target="_top"> Project Guidelines</a></p>
<p><a href="../../../../usergroup/index.shtml" target="_top">User Group</a></p>
<p><a href="../../../../training/index.shtml" target="_top">Training Materials</a></p>
</td>
</tr>
</table>
<table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0">
<tr>
<td><img src="../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td>
<td width="100%"> Last Updated:
<!-- #BeginEditable "date-stamp" -->
28th April 2008
<!-- #EndEditable --></td>
</tr>
</table>
]]>