<!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=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=749>
<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;">ruleE</span>ltNumber<span 
 style="font-style: italic;">1</span> to<span style="font-style: italic;"> 
 ruleEltNumber2</span> and name the group node <span style="font-style: italic;">labelString</span>.</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(ruleEltNumber1, ruleEltNumber2, 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;">ruleEltNumber1 - type: int<br>
ruleEltNumber2 - type: int<br>
labelString - type: str</p>

<h2>Returns</h2>

<h2>Remarks</h2>

<p style="color: #ff0000; font-weight: bold;">NOTE: the old group action 
 documented here has long been replaced by a more flexible group function. 
 <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->Rather 
 than rule element numbers, the first two arguments are the first node 
 and the last node of a range (which may be the same node). <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->As 
 of VisualText 2.3.1.9, the group function also returns the reduce node 
 that it creates, rather than a boolean &quot;ok&quot;. <!--kadov_tag{{<spaces>}}-->&nbsp;<!--kadov_tag{{</spaces>}}-->As 
 mentioned here, group 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 action.</p>

<!--(Table)=========================================================-->
<table x-use-null-cells
		wrapperparagraphselector=P
		style="width: 90%;
				margin-top: 14pt;
				border-spacing: 0px;
				border-spacing: 0px;"
		cellspacing=0
		width=90%>

<tr>
<td COLSPAN=2
	style="background-color: #FFFFD5;
			x-cell-content-align: TOP;
			width: 97%;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top
	bgcolor=#FFFFD5
	width=97%>
<p style="text-align: left; margin-bottom: 0;"
	align=left><span style="font-weight: bold;"><font style="color: #008080;"
														color=#008080>WARNING:</font><font 
 style="color: #800000;"
	color=#800000> </font></span><span style="color: #008080;">The rule 
 element numbers change after each group action, so subsequent POST Actions 
 must account for the new numbering of the rule elements. Reimplemented 
 as an NLP++ function so that args can be NLP++ expressions.</span></td>
<td_null></tr>
</table>

<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>
group(1,2,&quot;_np&quot;);<span 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;"><br>
@RULES<br>
_xNIL &lt;- _det _noun _xWILD [s lookahead fail=(_noun)] @@</span></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.htm">group function</a></p>

<p>&nbsp;</p>

</body>

</html>
