Previous (XmlNode function) - Revision history

JAL: /* Examples */

2014-03-03T20:59:07Z

Examples

← Older revision		Revision as of 20:59, 3 March 2014
Line 47:		Line 47:
	<b/>		<b/>
	</p>		</p>
	'''Note:''' You might expect a statement sequence like this next one to also obtain the <code>b</code> node as above:		<blockquote class="note">
			<p>'''Note:''' You might expect a statement sequence like this next one to also obtain the <code>b</code> node as above: </p>
	<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()')		<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()')
	print 'Here is the preceding-sib to 3:'		print 'Here is the preceding-sib to 3:'
Line 60:		Line 61:
	<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')		<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')
	</p>		</p>
	<li><div id="PreviousEx2"></div>Given the following document:		</blockquote>

			<li><div id="PreviousEx2"></div>
			Given the following document:
	<p class="code"><top>		<p class="code"><top>
	<F b1="b1" b2="b2" b3="b3" b4="b4"/>		<F b1="b1" b2="b2" b3="b3" b4="b4"/>
Line 74:		Line 78:
	b2="b2"		b2="b2"
	</p>		</p>
	'''Note:'''		<blockquote class="note">
			<p>'''Note:'''
	The preceding-sibling axis does ''not'' locate <var>Attribute</var> nodes. The following statement causes a request cancellation:		The preceding-sibling axis does ''not'' locate <var>Attribute</var> nodes. The following statement causes a request cancellation:
	<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')		<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')
	</p>		</p>
			</blockquote>
	</ol>		</ol>

	==See also==		==See also==
	{{Template:XmlNode:Previous footer}}		{{Template:XmlNode:Previous footer}}

JAL: /* Usage notes */

2014-03-03T20:56:53Z

Usage notes

← Older revision		Revision as of 20:56, 3 March 2014
Line 20:		Line 20:
	<ul>		<ul>
	<li>The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet if the context node is an <var>Attribute</var> node. The <var>[[Next_(XmlNode_function)\|Next]]</var> and <var>Previous</var> methods are available if you want to traverse the <var>Attribute</var> nodes of an <var>Element</var>, as a better approach than using the following-sibling and preceding-sibling axes in an XPath argument to a <var>[[SelectNodes_(XmlDoc/XmlNode_function)\|SelectNodes]]</var> or <var>SelectSingleNode</var> method. See [[#PreviousEx2\|example 2]] below.		<li>The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet if the context node is an <var>Attribute</var> node. The <var>[[Next_(XmlNode_function)\|Next]]</var> and <var>Previous</var> methods are available if you want to traverse the <var>Attribute</var> nodes of an <var>Element</var>, as a better approach than using the following-sibling and preceding-sibling axes in an XPath argument to a <var>[[SelectNodes_(XmlDoc/XmlNode_function)\|SelectNodes]]</var> or <var>SelectSingleNode</var> method. See [[#PreviousEx2\|example 2]] below.
	~~<li><var>Previous</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.0.~~
	</ul>		</ul>

JAL2 at 20:34, 3 June 2011

2011-06-03T20:34:01Z

← Older revision		Revision as of 20:34, 3 June 2011
Line 1:		Line 1:
	{{Template:XmlNode:Previous subtitle}}		{{Template:XmlNode:Previous subtitle}}
	<var>Previous</var> returns the previous <var>XmlNode</var> ~~with~~ the same parent as the method object.		<var>Previous</var> returns the previous <var>XmlNode</var> that has the same parent as the method object.
	<ul>		<ul>
	<li>If the method object is a non-<var>Attribute</var> node, the previous <var>XmlNode</var> is the previous sibling (in document order) of the method object. This is exactly the same as the node returned by <var>[[SelectSingleNode_(XmlDoc/XmlNode_function)\|~~selectSingleNode~~]]</var> with <code>'preceding-sibling::node()[1]'</code> as its [[XPath]] argument. This is demonstrated below in ~~item~~ [[#PreviousEx1\|"example 1"]] .		<li>If the method object is a non-<var>Attribute</var> node, the previous <var>XmlNode</var> is the previous sibling (in document order) of the method object. This is exactly the same as the node returned by <var>[[SelectSingleNode_(XmlDoc/XmlNode_function)\|SelectSingleNode]]</var> with <code>'preceding-sibling::node()[1]'</code> as its [[XPath]] argument. This is demonstrated below in [[#PreviousEx1\|example 1]] .
	<li>If the method object is an <var>Attribute</var> node, the previous <var>XmlNode</var> is the preceding <var>Attribute</var> node produced if the <var>Element</var> containing the method object were serialized in "normal" (that is, ''not'' ExclCanonical) order.		<li>If the method object is an <var>Attribute</var> node, the previous <var>XmlNode</var> is the preceding <var>Attribute</var> node produced if the <var>Element</var> containing the method object were serialized in "normal" (that is, ''not'' <var>ExclCanonical</var>) order.
	<li>If no "previous" node exists, the <var>Previous</var> method returns a Null.		<li>If no "previous" node exists, the <var>Previous</var> method returns a <var>Null</var>.
	</ul>		</ul>

Line 19:		Line 19:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet if the context node is an <var>Attribute</var> node. The <var>[[Next_(XmlNode_function)\|Next]]</var> and <var>Previous</var> methods are available if you want to traverse the <var>Attribute</var> nodes of an <var>Element</var>, as a better approach than using the following-sibling and preceding-sibling axes in an XPath argument to a <var>[[SelectNodes_(XmlDoc/XmlNode_function)\|~~selectNodes~~]]</var> or <var>SelectSingleNode</var> method. See: [[#PreviousEx2\|"example 2"]].		<li>The XPath recommendation specifies that the following-sibling and preceding-sibling axes are the empty nodeSet if the context node is an <var>Attribute</var> node. The <var>[[Next_(XmlNode_function)\|Next]]</var> and <var>Previous</var> methods are available if you want to traverse the <var>Attribute</var> nodes of an <var>Element</var>, as a better approach than using the following-sibling and preceding-sibling axes in an XPath argument to a <var>[[SelectNodes_(XmlDoc/XmlNode_function)\|SelectNodes]]</var> or <var>SelectSingleNode</var> method. See [[#PreviousEx2\|example 2]] below.
	<li><var>Previous</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.0.		<li><var>Previous</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.0.
	</ul>		</ul>
Line 76:		Line 76:
	</p>		</p>
	'''Note:'''		'''Note:'''
	The preceding-sibling axis does ''not'' locate ''Attribute'' nodes. The following statement causes a request cancellation:		The preceding-sibling axis does ''not'' locate <var>Attribute</var> nodes. The following statement causes a request cancellation:
	<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')		<p class="code">%n2 = %n1:selectSingleNode('preceding-sibling::node()[1]')
	</p>		</p>

Goff: edits, tags and links

2011-05-29T03:26:11Z

edits, tags and links

Show changes

DmeWiccan: 1 revision

2011-05-24T21:35:01Z

1 revision

New page

{{Template:XmlNode:Previous subtitle}}

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

The <var>Previous</var> function is new as of version 7.0 of the <var class="product">Sirius Mods</var>.
==Syntax==
{{Template:XmlNode:Previous syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%outNod</th>
<td>An <var>XmlNode</var>, which will be set to point to the returned node. </td></tr>
<tr><th>nod</th>
<td>An <var>XmlNode</var> expression.</td></tr>
</table>

==Usage notes==
<ul>
<li>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 <var>Previous</var> 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..
</ul>

==Examples==
<ol>
<li>Given the following document:
<top>
<a/>

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


To select the node that precedes Element <tt>c</tt>, you can use
a sequence of statements like the following:
%n1 is object <var>XmlNode</var>
%n1 = %doc:SelectSingleNode('/*/*[3]')
Print 'Here is node 3:'
%n1:Print
%n2 = %n1:<var>Previous</var>
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:



'''Note:'''
You might expect a statement sequence like
this next one to also obtain the <tt>b</tt> 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, <tt>b</tt>, then <tt>a</tt>), 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]')

<li>Given the following document:
<top>
<F b1="b1" b2="b2" b3="b3" b4="b4"/>
</top>


To select the Attribute node that precedes Attribute <tt>b3</tt>, you can use
a sequence of statements like the following:
%n1 = %doc:SelectSingleNode('/*/F/@b3'):<var>Previous</var>
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]')

</ol>
==See also==
{{Template:XmlNode:Previous footer}}

Wiccan: 1 revision

2011-02-07T17:36:56Z

1 revision

← Older revision	Revision as of 17:36, 7 February 2011
(No difference)

Wiccan: 1 revision

2011-02-07T17:36:54Z

1 revision

← Older revision		Revision as of 17:36, 7 February 2011
Line 43:		Line 43:
	<li>Given the following document:		<li>Given the following document:
	<p class="code"><top>		<p class="code"><top>
	~~<p class="code">~~<a/>		<a/>
	<b/>		<b/>
	<c/>		<c/>
	<d/>		<d/>
	<e/>		<e/>
	~~</p~~>
	</top>		</top>
	</p>		</p>
Line 94:		Line 93:
	<li>Given the following document:		<li>Given the following document:
	<p class="code"><top>		<p class="code"><top>
	~~<p class="code">~~<F b1="b1" b2="b2" b3="b3" b4="b4"/>		<F b1="b1" b2="b2" b3="b3" b4="b4"/>
	~~</p~~>
	</top>		</top>
	</p>		</p>

Wiccan: 1 revision

2011-02-06T22:33:28Z

1 revision

← Older revision	Revision as of 22:33, 6 February 2011
(No difference)

Wiccan: 1 revision

2011-02-06T22:33:25Z

1 revision

← Older revision		Revision as of 22:33, 6 February 2011
Line 43:		Line 43:
	<li>Given the following document:		<li>Given the following document:
	<p class="code"><top>		<p class="code"><top>
	<a/>		<p class="code"><a/>
	<b/>		<b/>
	<c/>		<c/>
	<d/>		<d/>
	<e/>		<e/>
			</p>
	</top>		</top>
	</p>		</p>
Line 93:		Line 94:
	<li>Given the following document:		<li>Given the following document:
	<p class="code"><top>		<p class="code"><top>
	<F b1="b1" b2="b2" b3="b3" b4="b4"/>		<p class="code"><F b1="b1" b2="b2" b3="b3" b4="b4"/>
			</p>
	</top>		</top>
	</p>		</p>

Wiccan: 1 revision

2011-01-25T17:46:17Z

1 revision

← Older revision	Revision as of 17:46, 25 January 2011
(No difference)