SelectCount (XmlDoc/XmlNode function) - Revision history

JAL: minor cleanup

2015-02-18T17:47:54Z

minor cleanup

← Older revision		Revision as of 17:47, 18 February 2015
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:XmlDoc/XmlNode:SelectCount syntax}}		{{Template:XmlDoc/XmlNode:SelectCount syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>A numeric variable that receives the count of nodes on the nodelist selected by the <var class="term">xpath</var> expression.</td></tr>		<td>A numeric variable that receives the count of nodes on the nodelist selected by the <var class="term">xpath</var> expression.</td></tr>

	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>

	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The count of nodes in this nodelist is returned.		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The count of nodes in this nodelist is returned.
	<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>
			Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>

Line 21:		Line 25:

	==Examples==		==Examples==
	<ol><li>In the following example, <var>SelectCount</var> counts the "a" node children of node "top," then the text node children of those "a" nodes:		<ol>
			<li>In the following example, <var>SelectCount</var> counts the "a" node children of node "top," then the text node children of those "a" nodes:
	<p class="code">begin		<p class="code">begin
	%doc is object XmlDoc		%doc is object XmlDoc
Line 35:		Line 40:
	</p>		</p>
	The example results follow:		The example results follow:
	<p class="~~code~~"><top>		<p class="output"><top>
	<a>a1</a>		<a>a1</a>
	<a>a2</a>		<a>a2</a>
Line 41:		Line 46:
	</top>		</top>
	3 and 3		3 and 3
	</p>		</p></li>

	<li>The following statements count all the nodes and all the attributes in the document, respectively.		<li>The following statements count all the nodes and all the attributes in the document, respectively.
	<p class="code">print 'Count of non-attribute nodes:' and %doc:countSelected('//node()')		<p class="code">print 'Count of non-attribute nodes:' and %doc:countSelected('//node()')
	print 'Count of attribute nodes:' and %doc:countSelected('//@*')		print 'Count of attribute nodes:' and %doc:countSelected('//@*')
	</p></ol>		</p></li>
			</ol>

	==Request-cancellation errors==		==Request-cancellation errors==
Line 56:		Line 63:
	==See also==		==See also==
	<ul>		<ul>
	<li><var>[[Count_(XmlNodelist_function)\|Count]]</var> counts the number of nodes on an <var>XmlNodelist</var>.		<li><var>[[Count_(XmlNodelist_function)\|Count]]</var> counts the number of nodes on an <var>XmlNodelist</var>.</li>
	<li>For more information about using XPath expressions, see [[XPath~~\|"XPath"~~]].
			<li>For more information about using XPath expressions, see [[XPath]].</li>
	</ul>		</ul>

	{{Template:XmlDoc/XmlNode:SelectCount footer}}		{{Template:XmlDoc/XmlNode:SelectCount footer}}

JAL: /* Request-cancellation errors */

2014-03-03T21:01:01Z

Request-cancellation errors

← Older revision		Revision as of 21:01, 3 March 2014
Line 48:		Line 48:

	==Request-cancellation errors==		==Request-cancellation errors==
			This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.
	<ul>		<ul>
	<li>The <var class="term">xpath</var> expression is invalid.		<li>The <var class="term">xpath</var> expression is invalid.

JAL2 at 15:37, 6 June 2011

2011-06-06T15:37:53Z

← Older revision		Revision as of 15:37, 6 June 2011
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>A numeric variable that receives the count of nodes on the ~~<var>XmlNodelist</var>~~ selected by the <var class="term">xpath</var>.</td></tr>		<td>A numeric variable that receives the count of nodes on the nodelist selected by the <var class="term">xpath</var> expression.</td></tr>
	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
Line 47:		Line 47:
	</p></ol>		</p></ol>

	==Request-~~Cancellation Errors~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">xpath</var> is invalid.		<li>The <var class="term">xpath</var> expression is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL2 at 23:51, 23 May 2011

2011-05-23T23:51:47Z

← Older revision		Revision as of 23:51, 23 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectCount subtitle}}		{{Template:XmlDoc/XmlNode:SelectCount subtitle}}
	<var>SelectCount</var> counts the number of nodes selected by an [[XPath#XPath_syntax\|~~Xpath~~ expression]].		<var>SelectCount</var> counts the number of nodes selected by an [[XPath#XPath_syntax\|XPath expression]].

	==Syntax==		==Syntax==
Line 11:		Line 11:
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|~~Xpath~~ expression]] that results in a ~~<var>~~nodelist~~</var>~~. The count of nodes in this ~~<var>~~nodelist~~</var>~~ is returned.		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The count of nodes in this nodelist is returned.
	<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>
Line 17:		Line 17:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the result of the argument ~~<var>~~XPath~~</var>~~ expression (<var class="term">~~XPath~~</var>) is empty, numeric zero is returned.		<li>If the result of the argument XPath expression (<var class="term">xpath</var>) is empty, numeric zero is returned.
	</ul>		</ul>

	==Examples==		==Examples==
	<ol>		<ol><li>In the following example, <var>SelectCount</var> counts the "a" node children of node "top," then the text node children of those "a" nodes:
	<li>In the following example, <var>SelectCount</var> counts the "a" node children of node "top," then the text node children of those "a" nodes:
	<p class="code">begin		<p class="code">begin
	%doc is object XmlDoc		%doc is object XmlDoc
Line 46:		Line 45:
	<p class="code">print 'Count of non-attribute nodes:' and %doc:countSelected('//node()')		<p class="code">print 'Count of non-attribute nodes:' and %doc:countSelected('//node()')
	print 'Count of attribute nodes:' and %doc:countSelected('//@*')		print 'Count of attribute nodes:' and %doc:countSelected('//@*')
	</p>		</p></ol>
	</ol>

	==Request-Cancellation Errors==		==Request-Cancellation Errors==
	<ul>		<ul>
	<li><var class="term">~~XPath~~</var> is invalid.		<li><var class="term">xpath</var> is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL2 at 20:29, 23 May 2011

2011-05-23T20:29:05Z

← Older revision		Revision as of 20:29, 23 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectCount subtitle}}		{{Template:XmlDoc/XmlNode:SelectCount subtitle}}
	<var>SelectCount</var> counts the number of nodes selected by an ~~<var>~~[[XPath#XPath_syntax\|Xpath expression]]~~</var>~~.		<var>SelectCount</var> counts the number of nodes selected by an [[XPath#XPath_syntax\|Xpath expression]].

	==Syntax==		==Syntax==
Line 11:		Line 11:
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an ~~<var>~~[[XPath#XPath_syntax\|Xpath expression]]~~</var>~~ that results in a <var>nodelist</var>. The count of nodes in this <var>nodelist</var> is returned.		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|Xpath expression]] that results in a <var>nodelist</var>. The count of nodes in this <var>nodelist</var> is returned.
	<p>Prior to <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>

Line 57:		Line 57:
	==See also==		==See also==
	<ul>		<ul>
	<li><var>[[Count_(XmlNodelist_function)\|~~count~~]]</var> counts the number of nodes on an <var>XmlNodelist</var>.		<li><var>[[Count_(XmlNodelist_function)\|Count]]</var> counts the number of nodes on an <var>XmlNodelist</var>.
	<li>For more information about using XPath expressions, see [[XPath]].		<li>For more information about using XPath expressions, see [[XPath\|"XPath"]].
	</ul>		</ul>
	{{Template:XmlDoc/XmlNode:SelectCount footer}}		{{Template:XmlDoc/XmlNode:SelectCount footer}}

Goff: edits, tags and links

2011-05-22T09:52:05Z

edits, tags and links

← Older revision		Revision as of 09:52, 22 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectCount subtitle}}		{{Template:XmlDoc/XmlNode:SelectCount subtitle}}
			<var>SelectCount</var> counts the number of nodes selected by an <var>[[XPath#XPath_syntax\|Xpath expression]]</var>.

	~~This method counts the number of nodes selected by an <var>[[XPath#XPath_syntax\|Xpath expression]]</var>.~~
	==Syntax==		==Syntax==
	{{Template:XmlDoc/XmlNode:SelectCount syntax}}		{{Template:XmlDoc/XmlNode:SelectCount syntax}}
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>A numeric variable ~~for~~ the ~~number~~ of nodes on <var>XmlNodelist</var> <i>~~nlis~~</i>. </td></tr>		<td>A numeric variable that receives the count of nodes on the <var>XmlNodelist</var> selected by the <var class="term">xpath</var>.</td></tr>
	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the Root node is the context node. </td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an <var>[[XPath#XPath_syntax\|Xpath expression]]</var> that results in a nodelist. The count of nodes in this nodelist is returned.		<td>A <var>Unicode</var> string that is an <var>[[XPath#XPath_syntax\|Xpath expression]]</var> that results in a <var>nodelist</var>. The count of nodes in this <var>nodelist</var> is returned.
			<p>Prior to <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	Prior to ''Sirius Mods~~'' version~~ 7.6, this is an EBCDIC string.</td></tr>

	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the result of the argument XPath expression (<i>XPath</i>) is empty,		<li>If the result of the argument <var>XPath</var> expression (<var class="term">XPath</var>) is empty, numeric zero is returned.
	zero is returned.
	</ul>		</ul>

	==Examples==		==Examples==
	<ul>		<ol>
	<li>In the following example, <var>SelectCount</var> counts the "a" node		<li>In the following example, <var>SelectCount</var> counts the "a" node children of node "top," then the text node children of those "a" nodes:
	children of node "top," then the text node children of		<p class="code">begin
	those "a" nodes:		%doc is object XmlDoc
	<p class="code">~~Begin~~		%j is float
	%doc is ~~Object~~ XmlDoc		%k is float
	%j is ~~Float~~		%doc = new
	%k is ~~Float~~		%doc:[[LoadXml_(XmlDoc/XmlNode_function)\|loadXml]]('<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')
	%doc = ~~New~~		[[Notation_conventions_for_methods#Callable_methods\|Call]] %doc:print('/')
	%doc:~~LoadXml~~('<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')		%j = %doc:selectCount('/top/a')
	Call %doc:~~Print~~('/')		%k = %doc:selectCount('/top/a/text()')
	%j = %doc:~~SelectCount~~('/top/a')		print %j ' and ' %k
	%k = %doc:~~SelectCount~~('/top/a/text()')		end
	~~Print~~ %j ' and ' %k
	~~End~~
	</p>		</p>

	The example results follow:		The example results follow:
	<p class="code"><top>		<p class="code"><top>
Line 49:		Line 43:
	3 and 3		3 and 3
	</p>		</p>
	<li>The following		<li>The following statements count all the nodes and all the attributes in the document, respectively.
	statements count all the nodes ~~in the document~~		<p class="code">print 'Count of non-attribute nodes:' and %doc:countSelected('//node()')
	and all the attributes in the document, respectively.		print 'Count of attribute nodes:' and %doc:countSelected('//@*')
	<p class="code">~~Print~~ 'Count of non-attribute nodes:' ~~And~~ %doc:~~CountSelected~~('//node()')
	~~Print~~ 'Count of attribute nodes:' ~~And~~ %doc:~~CountSelected~~('//@*')
	</p>		</p>
	</ul>		</ol>

	==Request-Cancellation Errors==		==Request-Cancellation Errors==
	<ul>		<ul>
	<li><i>XPath</i> is invalid.		<li><var class="term">XPath</var> is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

	==See also==		==See also==
	~~{{Template:XmlDoc/XmlNode:SelectCount footer}}~~

	<ul>		<ul>
	<li>[[??]] ~~reftxt=Count refid=count.~~ counts the number of nodes on an <var>XmlNodelist</var>.		<li><var>[[Count_(XmlNodelist_function)\|count]]</var> counts the number of nodes on an <var>XmlNodelist</var>.
	<li>For more information about using XPath expressions, see [[XPath]].		<li>For more information about using XPath expressions, see [[XPath]].
	</ul>		</ul>
			{{Template:XmlDoc/XmlNode:SelectCount footer}}

Goff: xpath expression

2011-05-22T09:19:05Z

xpath expression

New page

{{Template:XmlDoc/XmlNode:SelectCount subtitle}}

This method counts the number of nodes selected by an <var>[[XPath#XPath_syntax|Xpath expression]]</var>.
==Syntax==
{{Template:XmlDoc/XmlNode:SelectCount syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%number</th>
<td>A numeric variable for the number of nodes on <var>XmlNodelist</var> nlis. </td></tr>
<tr><th>nr</th>
<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the Root node is the context node. </td></tr>
<tr><th>xpath</th>
<td>A <var>Unicode</var> string that is an <var>[[XPath#XPath_syntax|Xpath expression]]</var> that results in a nodelist. The count of nodes in this nodelist is returned.

Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr>

</table>

==Usage notes==
<ul>
<li>If the result of the argument XPath expression (XPath) is empty,
zero is returned.
</ul>

==Examples==
<ul>
<li>In the following example, <var>SelectCount</var> counts the "a" node
children of node "top," then the text node children of
those "a" nodes:
Begin
%doc is Object XmlDoc
%j is Float
%k is Float
%doc = New
%doc:LoadXml('<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')
Call %doc:Print('/')
%j = %doc:SelectCount('/top/a')
%k = %doc:SelectCount('/top/a/text()')
Print %j ' and ' %k
End


The example results follow:
<top>
<a>a1</a>
<a>a2</a>
<a>a3</a>
</top>
3 and 3

<li>The following
statements count all the nodes in the document
and all the attributes in the document, respectively.
Print 'Count of non-attribute nodes:' And %doc:CountSelected('//node()')
Print 'Count of attribute nodes:' And %doc:CountSelected('//@*')

</ul>

==Request-Cancellation Errors==
<ul>
<li>XPath is invalid.
<li>Insufficient free space exists in CCATEMP.
</ul>

==See also==
{{Template:XmlDoc/XmlNode:SelectCount footer}}

<ul>
<li>[[??]] reftxt=Count refid=count. counts the number of nodes on an <var>XmlNodelist</var>.
<li>For more information about using XPath expressions, see [[XPath]].
</ul>

Wiccan: 1 revision

2011-02-08T16:34:09Z

1 revision

← Older revision	Revision as of 16:34, 8 February 2011
(No difference)

Dme: /* Examples */

2011-02-08T16:34:08Z

Examples

← Older revision		Revision as of 16:34, 8 February 2011
Line 12:		Line 12:
	<tr><th>XPath</th>		<tr><th>XPath</th>
	<td>A <var>Unicode</var> string that is an XPath expression that results in a nodelist. The count of nodes in this nodelist is returned.		<td>A <var>Unicode</var> string that is an XPath expression that results in a nodelist. The count of nodes in this nodelist is returned.
	~~<p class="code">~~Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr>
	~~</p>~~		Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr>

	</table>		</table>

Dme: /* Examples */

2011-02-07T20:00:36Z

Examples

← Older revision		Revision as of 20:00, 7 February 2011
Line 28:		Line 28:
	those "a" nodes:		those "a" nodes:
	<p class="code">Begin		<p class="code">Begin
	%doc is ~~<var>~~Object~~</var> <var>~~XmlDoc~~</var>~~		%doc is Object XmlDoc
	%j is ~~<var>~~Float~~</var>~~		%j is Float
	%k is ~~<var>~~Float~~</var>~~		%k is Float
	%doc = New		%doc = New
	%doc:LoadXml('<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')		%doc:LoadXml('<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')
	Call %doc:Print('/')		Call %doc:Print('/')
	%j = %doc:~~<var>~~SelectCount~~</var>~~('/top/a')		%j = %doc:SelectCount('/top/a')
	%k = %doc:~~<var>~~SelectCount~~</var>~~('/top/a/text()')		%k = %doc:SelectCount('/top/a/text()')
	Print %j ' and ' %k		Print %j ' and ' %k
	End		End
Line 42:		Line 42:
	The example results follow:		The example results follow:
	<p class="code"><top>		<p class="code"><top>
	<a>a1</a>		<a>a1</a>
	<a>a2</a>		<a>a2</a>
	<a>a3</a>		<a>a3</a>
	~~</p~~>
	</top>		</top>
	3 and 3		3 and 3
Line 57:		Line 56:
	</ul>		</ul>

	===Request-Cancellation Errors===		==Request-Cancellation Errors==
	<ul>		<ul>
	<li><i>XPath</i> is invalid.		<li><i>XPath</i> is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>


	==See also==		==See also==