Length (XmlDoc/XmlNode function): Difference between revisions

Revision as of 16:57, 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.

%number = nr:Length[( [xpath])] Throws XPathError

%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.

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

@@ Line 1: / Line 1: @@
-<span style="font-size:120%; color:black"><b>Length of string-value of selected node</b></span>
+{{Template:XmlDoc/XmlNode:Length subtitle}}
 [[Category:XmlDoc methods|Length function]]
 [[Category:XmlNode methods|Length function]]
@@ Line 13: / Line 13: @@
 The Length function gets the length of the string-value of a node, which includes
 its Text descendants.
-===Syntax===
+==Syntax==
-   %len = nr:Length([XPath])
+{{Template:XmlDoc/XmlNode:Length syntax}}
+===Syntax terms===
-====Syntax Terms====
 <dl>
 <dt>%len
@@ Line 36: / Line 35: @@
 The following example displays
-the value &ldquo;13&rdquo;:
+the value "13":
 <pre>
      Begin