SelectCount (XmlDoc/XmlNode function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:XmlDoc/XmlNode:SelectCount subtitle}} | |||
[[Category:XmlDoc methods|SelectCount function]] | [[Category:XmlDoc methods|SelectCount function]] | ||
[[Category:XmlNode methods|SelectCount function]] | [[Category:XmlNode methods|SelectCount function]] | ||
| Line 12: | Line 12: | ||
This method counts the number of nodes selected by an XPath expression. | This method counts the number of nodes selected by an XPath expression. | ||
==Syntax== | |||
{{Template:XmlDoc/XmlNode:SelectCount syntax}} | |||
===Syntax terms=== | |||
<dl> | <dl> | ||
<dt>%count | <dt>%count | ||
| Line 31: | Line 30: | ||
</dl> | </dl> | ||
==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 XPath expression (<i>XPath</i>) is empty, | ||
| Line 37: | Line 36: | ||
</ul> | </ul> | ||
==Examples== | |||
<ul> | <ul> | ||
<li>In the following example, SelectCount counts the | <li>In the following example, SelectCount counts the "a" node | ||
children of node | children of node "top," then the text node children of | ||
those | those "a" nodes: | ||
<pre> | <pre> | ||
Begin | Begin | ||
Revision as of 16:57, 22 January 2011
Number of selected nodes (XmlDoc and XmlNode classes)
SelectCount is a member of the XmlDoc and XmlNode classes.
This method counts the number of nodes selected by an XPath expression.
Syntax
%number = nr:SelectCount( xpath) Throws XPathError
Syntax terms
- %count
- A numeric variable for the number of nodes on XmlNodelist nlis.
- nr
- An XmlDoc or XmlNode, used as the context node for the XPath expression. If an XmlDoc, the Root node is the context node.
- XPath
- A Unicode string that is an XPath expression 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.
Usage notes
- If the result of the argument XPath expression (XPath) is empty, zero is returned.
Examples
- In the following example, SelectCount 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 EndThe example results follow:
<top> <a>a1</a> <a>a2</a> <a>a3</a> </top> 3 and 3 - 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('//@*')
Request-Cancellation Errors
- XPath is invalid.
- Insufficient free space exists in CCATEMP.