Next (XmlNode function)

From m204wiki
Revision as of 20:54, 3 March 2014 by JAL (talk | contribs) (→‎Examples)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Get the next node after this node (XmlNode class)

The Next function returns the next XmlNode that has the same parent as the method object.

  • If the method object is a non-Attribute node, the next XmlNode is the next sibling (in document order) of the method object. This is exactly the same as the node returned by SelectSingleNode specifying 'following-sibling::node()' for the value of its xpath argument.
  • If the method object is an Attribute node, the next XmlNode is the next Attribute node produced if the Element containing the method object were serialized in "normal" (that is, not ExclCanonical) order.
  • If no "next" node exists, the Next method returns a Null.

Syntax

%outNod = nod:Next

Syntax terms

%outNod An XmlNode, which will be set to point to the returned node.
nod An XmlNode expression.

Usage notes

  • If no "next" node exists, the Next method returns a Null.
  • The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet when the context node is an Attribute node. The Next and Previous methods are available if you want to traverse the Attribute nodes of an Element, as a better approach than using the following-sibling and preceding-sibling axes in an xpath argument to a SelectNodes or SelectSingleNode method. For details, see example 2.

Examples

  1. Given the following document:

    <top> <a/> <c/> <d/> <e/> </top>

    To select the node that follows Element b, you can use a sequence of statements like the following:

    %n1 is object xmlNode %n1 = %doc:selectSingleNode('/*/*[2]') print 'Here is attribute node 2:' %n1:print %n2 = %n1:next print 'Here is the attribute node after 2:' %n2:print

    The result is:

    Here is attribute node 2: Here is the attribute node after 2: <c/>

    Note: The following statement obtains the same result as using Next, above:

    %n2 = %n1:SelectSingleNode('following-sibling::node()')

    The following-sibling axis generates resultant nodes in document order (in this case, c, then d), and the SelectSingleNode statement selects the first of these two generated nodes also in document order.

  2. Given the following document:

    <top> <F b1="b1" b2="b2" b3="b3" b4="b4"/> </top>

    To select the Attribute node that follows Attribute b2, you can use the following:

    %n1 = %doc:selectSingleNode('/*/F/@b2'):next print 'Here is attribute after b2:' %n1:print

    The result is:

    Here is attribute after b2: b3="b3"

    Note: The following-sibling axis does not locate Attribute nodes. This statement causes a request cancellation:

    %n2 = %n1:selectSingleNode('following-sibling::node()')

See also