Length (XmlDoc/XmlNode function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (1 revision) |
||
| Line 16: | Line 16: | ||
{{Template:XmlDoc/XmlNode:Length syntax}} | {{Template:XmlDoc/XmlNode:Length syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
< | <table class="syntaxTable"> | ||
< | <tr><th>%len</th> | ||
< | <td>A numeric variable to contain the returned value from Length. </td></tr> | ||
< | <tr><th>nr</th> | ||
< | <td>An XmlDoc or XmlNode, used as the context node for the <i>XPath</i> expression. If an XmlDoc, the Root node is the context node. </td></tr> | ||
<i>XPath</i> expression. | <tr><th>XPath</th> | ||
If an XmlDoc, the Root node is the context node. | <td>A Unicode string that is an XPath expression that results in a nodelist. The head of the nodelist is the node to process. An optional argument, its default is a period (.), that is, the node referenced by the method object (<i>nr</i>). | ||
< | Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr> | ||
< | </table> | ||
The head of the nodelist is the node to process. | |||
An optional argument, its default is a period (.), that is, | |||
the node referenced by the method object (<i>nr</i>). | |||
Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string. | |||
</ | |||
===Example=== | ===Example=== | ||
Revision as of 17:50, 22 January 2011
Length of string-value of selected node (XmlDoc and XmlNode classes)
Length is a member of the XmlDoc and XmlNode classes.
The Length function gets the length of the string-value of a node, which includes its Text descendants.
Syntax
%number = nr:Length[( [xpath])] Throws XPathError
Syntax terms
| %len | A numeric variable to contain the returned value from Length. |
|---|---|
| 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 head of the nodelist is the node to process. An optional argument, its default is a period (.), that is, the node referenced by the method object (nr). Prior to Sirius Mods version 7.6, this is an EBCDIC string. |
Example
The following example displays the value "13":
Begin
%d Object XmlDoc
%d:LoadXml('<t><a>Hell</a>' With -
'<b>o, world!'</b></t>')
Print %d:Length('/t')
End
Request-Cancellation Errors
- XPath is invalid.
- Result of (XPath) is empty.
- Insufficient free space exists in CCATEMP.