<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">

<html>

<!--(==============================================================)-->
<!--(Document created with RoboEditor. )============================-->
<!--(==============================================================)-->

<head>

<title>group</title>

<!--(Meta)==========================================================-->

<meta http-equiv=content-type content="text/html; charset=windows-1252">
<meta name=date content="01 4, 2002 11:52:14 AM">
<meta name=generator content="RoboHELP by eHelp Corporation - www.ehelp.com">
<meta name=generator-major-version content=0.1>
<meta name=generator-minor-version content=1>
<meta name=filetype content=kadov>
<meta name=filetype-version content=1>
<meta name=page-count content=1>
<meta name=layout-height content=847>
<meta name=layout-width content=1027>


<!--(Links)=========================================================-->

<link REL="StyleSheet" HREF="default.css">



</head>

<!--(Body)==========================================================-->


<body>

<h1>group</h1>

<h2>Purpose</h2>

<p><span style="color: #ff0000; font-weight: bold;">SEE NOTE BELOW.</span> 
 <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->Perform 
 a reduction on the range of rule elements from <span style="font-style: italic;">node1 
 </span>to<span style="font-style: italic;"> node2 </span>and name the 
 group node <span style="font-style: italic;">labelString</span>. <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->node1 
 and node2 should be a well-formed range in the current rule match. <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->For 
 example from N(1) to N(3).</p>

<h2>Syntax</h2>

<p style="line-height: normal;
			margin-bottom: 14pt;
			margin-top: 14pt;
			x-text-tab-stops: repeat 1in;
			white-space: nowrap;
			font-family: monospace;
			font-size: 10pt;">group(node1, node2, labelString)</p>

<p style="margin-left: 40px;
			line-height: normal;
			margin-bottom: 14pt;
			margin-top: 14pt;
			x-text-tab-stops: repeat 1in;
			white-space: nowrap;
			font-family: monospace;
			font-size: 10pt;">node1- type: parse tree node<br>
node2 - type: parse tree node<br>
labelString - type: str</p>

<h2>Returns</h2>

<h2>Remarks</h2>

<p style="color: #ff0000; font-weight: bold;">NOTE: the old group action 
 has long been replaced by this more flexible group function. As of VisualText 
 2.3.1.9, the group function returns the reduce node that it creates, rather 
 than a boolean &quot;ok&quot;. <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->As 
 with the action, the group function alters the element numbers of subsequent 
 POST actions.</p>

<p>Unlike other reduce actions, <span style="font-weight: bold;">group</span> 
 can be repeated. <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->The 
 phrase element modifier <span style="font-weight: bold;"><a href="gp.htm">group</a></span> 
 is analogous to this function.</p>

<h2>Example</h2>

<p style="line-height: normal;
			margin-bottom: 14pt;
			margin-top: 14pt;
			x-text-tab-stops: repeat 1in;
			white-space: nowrap;
			font-family: monospace;
			font-size: 10pt;">@POST<br>
L(&quot;n&quot;) = group(N(1),N(2),&quot;_np&quot;);<br>
&quot;output.txt&quot; &lt;&lt; pnname(L(&quot;n&quot;)) &lt;&lt; &quot;\n&quot;;<br>
@RULES<br>
_xNIL &lt;- _det _noun _xWILD [s lookahead fail=(_noun)] @@</p>

<p style="line-height: normal;
			margin-bottom: 14pt;
			margin-top: 14pt;
			x-text-tab-stops: repeat 1in;
			white-space: nowrap;
			font-family: monospace;
			font-size: 10pt;">output.txt then gets an output like:</p>

<p style="line-height: normal;
			margin-bottom: 14pt;
			margin-top: 14pt;
			x-text-tab-stops: repeat 1in;
			white-space: nowrap;
			font-family: monospace;
			font-size: 10pt;">_np</p>

<h2>See Also</h2>

<p><a href="splice.htm">splice</a>, <a href="NLP_PP_Stuff/Phrase_element_modifiers.htm">Phrase 
 Element Modifiers</a>, <a href="NLP_PP_Stuff/AT-POST_Actions.htm#table_of_@POST_Actions">POST 
 Actions</a>, <a href="group_action.htm">group action</a></p>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p style="margin-bottom: 0;">&nbsp; </p>

</body>

</html>
