Previous (XmlNode function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
<span style="font-size:120%; color:black"><b>Previous XmlNode</b></span>
{{Template:XmlNode:Previous subtitle}}
[[Category:XmlNode methods|Previous function]]
[[Category:XmlNode methods|Previous function]]
[[Category:XmlDoc API methods]]
[[Category:XmlDoc API methods]]
Line 20: Line 20:
preceding Attribute
preceding Attribute
node produced if the Element containing the method object
node produced if the Element containing the method object
were serialized in &ldquo;normal&rdquo; (that is, ''not'' ExclCanonical) order.
were serialized in "normal" (that is, ''not'' ExclCanonical) order.
<li>If no &ldquo;previous&rdquo; node exists, the Previous method returns a Null.
<li>If no "previous" node exists, the Previous method returns a Null.
</ul>
</ul>


The Previous function is new as of version 7.0 of the ''Sirius Mods''.
The Previous function is new as of version 7.0 of the ''Sirius Mods''.
===Syntax===
==Syntax==
  %nod = nod:Previous
{{Template:XmlNode:Previous syntax}}
 
===Syntax terms===
====Syntax Terms====
<dl>
<dl>
<dt>%nod
<dt>%nod
Line 37: Line 36:
</dl>
</dl>


===Usage Notes===
==Usage notes==
<ul>
<ul>
<li>The XPath recommendation specifies that
<li>The XPath recommendation specifies that
Line 49: Line 48:
</ul>
</ul>


===Examples===
==Examples==
<ol>
<ol>
<li>Given the following document:
<li>Given the following document:

Revision as of 16:58, 22 January 2011

Get node previous to this node (XmlNode class)

Previous is a member of the XmlNode class.

This function returns the previous XmlNode with the same parent as the method object.

  • If the method object is a non-Attribute node, the previous XmlNode is the previous sibling (in document order) of the method object. This is exactly the same as the node returned by SelectSingleNode with 'preceding-sibling::node()[1]' as its XPath argument. This is demonstrated below in item ?? refid=nonatt page=no. in ?? refid=egprev..
  • If the method object is an Attribute node, the previous XmlNode is the preceding Attribute node produced if the Element containing the method object were serialized in "normal" (that is, not ExclCanonical) order.
  • If no "previous" node exists, the Previous method returns a Null.

The Previous function is new as of version 7.0 of the Sirius Mods.

Syntax

%outNod = nod:Previous

Syntax terms

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

Usage notes

  • The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet if the context node is an Attribute node. The Next (?? reftxt="Next function" refid=nexmeth.) and Previous methods are available if you want to traverse the Attribute nodes of an Element, as a better approach than using the following&hyph.sibling and preceding&hyph.sibling axes in an XPath argument to a SelectNodes or SelectSingleNode method. See example ?? refid=attprev..

Examples

  1. Given the following document:
        <top>
          <a/>
          <b/>
          <c/>
          <d/>
          <e/>
        </top>
    

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

        %n1 is object XmlNode
        %n1 = %doc:SelectSingleNode('/*/*[3]')
        Print 'Here is node 3:'
        %n1:Print
        %n2 = %n1:Previous
        Print 'Here is the node previous to 3:'
        %n2:Print
    

    The result is:

        Here is node 3:
        <c/>
        Here is the node previous to 3:
        <b/>
    

    Note: You might expect a statement sequence like this next one to also obtain the b node as above:

        %n2 = %n1:SelectSingleNode('preceding-sibling::node()')
        Print 'Here is the preceding-sib to 3:'
        %n2:Print
    

    However, this is the result:

        Here is the preceding-sib to 3:
        <a/>
    

    The preceding-sibling axis generates resultant nodes in reverse document order (in this case, b, then a), which is probably what you intuitively expect. However, the SelectSingleNode statement selects the first of these two generated nodes :hp3.in document order:ehp3.. To use SelectSingleNode to select the adjacent preceding sibling node, use a predicate so the XPath argument selects the (only) node you want:

        %n2 = %n1:SelectSingleNode('preceding-sibling::node()[1]')
    
  2. Given the following document:
        <top>
           <F b1="b1" b2="b2" b3="b3" b4="b4"/>
        </top>
    

    To select the Attribute node that precedes Attribute b3, you can use a sequence of statements like the following:

        %n1 = %doc:SelectSingleNode('/*/F/@b3'):Previous
        Print 'Here is attribute previous to b3:'
        %n1:Print
    

    The result is:

        Here is attribute previous to b3:
        b2="b2"
    

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

        %n2 = %n1:SelectSingleNode('preceding-sibling::node()[1]')