SelectNodes (XmlDoc/XmlNode function) - Revision history

JAL: /* Request-cancellation errors */

2014-03-03T21:01:32Z

Request-cancellation errors

← Older revision		Revision as of 21:01, 3 March 2014
Line 91:		Line 91:

	==Request-cancellation errors==		==Request-cancellation errors==
			This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.
	<ul>		<ul>
	<li>The <var class="term">xpath</var> expression is invalid.		<li>The <var class="term">xpath</var> expression is invalid.

Alan at 21:22, 9 January 2012

2012-01-09T21:22:45Z

← Older revision		Revision as of 21:22, 9 January 2012
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}		{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}
	<var>SelectNodes</var> ~~stores, in~~ an <var>XmlNodelist</var>~~, the list of~~ nodes selected by an [[XPath#XPath_syntax\|XPath expression]].		<var>SelectNodes</var> creates an <var>XmlNodelist</var> containing nodes selected by an [[XPath#XPath_syntax\|XPath expression]].

	==Syntax==		==Syntax==
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%nodl</th>		<tr><th>%nodl</th>
	<td>An <var>XmlNodelist</var> that is ~~set to point to~~ the ~~nodelist that~~ is created.</td></tr>		<td>An <var>XmlNodelist</var> that is created, containing the nodes selected by the specified ''xpath''. If the selection results in no found nodes, an empty XMLNodelist is created.</td></tr>
	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
Line 17:		Line 17:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the result of the <var class="term">xpath</var> argument XPath expression is empty, ~~a <var>Null</var>~~ is returned.		<li>If the result of the <var class="term">xpath</var> argument XPath expression is empty, an empty XMLNodelist is returned.
	<li>The nodes found by <var>SelectNodes</var> are arranged in the resulting nodelist in document order. For some sets selected by XPath expressions (for example, the set of ancestor nodes),		<li>The nodes found by <var>SelectNodes</var> are arranged in the resulting nodelist in document order. For some sets selected by XPath expressions (for example, the set of ancestor nodes),
	document order may not be the ordering you intuitively expect. For a discussion of this issue, see [[XPath#Order_of_nodes:_node_sets_versus_nodelists\|“Order of nodes: node sets versus nodelists”]].		document order may not be the ordering you intuitively expect. For a discussion of this issue, see [[XPath#Order_of_nodes:_node_sets_versus_nodelists\|“Order of nodes: node sets versus nodelists”]].

JAL2 at 15:45, 6 June 2011

2011-06-06T15:45:15Z

← Older revision		Revision as of 15:45, 6 June 2011
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%nodl</th>		<tr><th>%nodl</th>
	<td>An <var>XmlNodelist</var> that is set to point to the ~~<var>~~nodelist~~</var>~~ that is created.</td></tr>		<td>An <var>XmlNodelist</var> that is set to point to the nodelist that is created.</td></tr>
	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a ~~<var>~~nodelist~~</var>~~. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<~~code~~>.</~~code~~>), that is, the node referenced by the method object (<var class="term">nr</var>).		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<tt>.</tt>), that is, the node referenced by the method object (<var class="term">nr</var>).
	<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>
Line 17:		Line 17:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the result of the ~~argument <var>XPath</var> expression (~~<var class="term">~~XPath~~</var>) is empty, a <var>Null</var> is returned.		<li>If the result of the <var class="term">xpath</var> argument XPath expression is empty, a <var>Null</var> is returned.
	<li>The nodes found by <var>SelectNodes</var> are arranged in the resulting ~~<var>~~nodelist~~</var>~~ in document order. For some sets selected by ~~<var>~~XPath~~</var>~~ expressions (for example, the set of ancestor nodes),		<li>The nodes found by <var>SelectNodes</var> are arranged in the resulting nodelist in document order. For some sets selected by XPath expressions (for example, the set of ancestor nodes),
	document order may not be the ordering you intuitively expect. For a discussion of this issue, see [[XPath#Order_of_nodes:_node_sets_versus_nodelists\|“Order of nodes: node sets versus nodelists”]].		document order may not be the ordering you intuitively expect. For a discussion of this issue, see [[XPath#Order_of_nodes:_node_sets_versus_nodelists\|“Order of nodes: node sets versus nodelists”]].
	</ul>		</ul>

Line 56:		Line 56:
	%i is float		%i is float
	%doc = new		%doc = new
	%doc:~~[[LoadXml_(XmlDoc/XmlNode_function)\|~~loadXml]]('<top><a><a1/></a><a><a2/></a><a><a3/></a></top>')		%doc:loadXml('<top><a><a1/></a><a><a2/></a><a><a3/></a></top>')
	~~[[Notation_conventions_for_methods#Callable_methods\|~~Call]] %doc:print		Call %doc:print
	%nl1 = %doc:selectNodes('/following::node()')		%nl1 = %doc:selectNodes('/following::node()')
	print %nl1:[[Count_(XmlNodelist_function)\|count]]		print %nl1:[[Count_(XmlNodelist_function)\|count]]
Line 90:		Line 90:
	</ol>		</ol>

	==Request-~~Cancellation Errors~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">xpath</var> is invalid.		<li>The <var class="term">xpath</var> expression is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL2 at 23:52, 23 May 2011

2011-05-23T23:52:57Z

← Older revision		Revision as of 23:52, 23 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}		{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}
	<var>SelectNodes</var> stores, in an <var>XmlNodelist</var>, the list of nodes selected by an [[XPath#XPath_syntax\|~~Xpath~~ expression]].		<var>SelectNodes</var> stores, in an <var>XmlNodelist</var>, the list of nodes selected by an [[XPath#XPath_syntax\|XPath expression]].

	==Syntax==		==Syntax==
Line 11:		Line 11:
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|~~Xpath~~ expression]] that results in a <var>nodelist</var>. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a <var>nodelist</var>. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).
	<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>

JAL2: /* Request-Cancellation Errors */

2011-05-23T23:46:06Z

Request-Cancellation Errors

← Older revision		Revision as of 23:46, 23 May 2011
Line 92:		Line 92:
	==Request-Cancellation Errors==		==Request-Cancellation Errors==
	<ul>		<ul>
	<li><var class="term">~~XPath~~</var> is invalid.		<li><var class="term">xpath</var> is invalid.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL2 at 20:32, 23 May 2011

2011-05-23T20:32:11Z

← Older revision		Revision as of 20:32, 23 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}		{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}
	<var>SelectNodes</var> stores, in an <var>XmlNodelist</var>, the list of nodes selected by an ~~<var>~~[[XPath#XPath_syntax\|Xpath expression]]~~</var>~~.		<var>SelectNodes</var> stores, in an <var>XmlNodelist</var>, the list of nodes selected by an [[XPath#XPath_syntax\|Xpath expression]].

	==Syntax==		==Syntax==
Line 11:		Line 11:
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>		<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the <var>Root</var> node is the context node.</td></tr>
	<tr><th>xpath</th>		<tr><th>xpath</th>
	<td>A <var>Unicode</var> string that is an ~~<var>~~[[XPath#XPath_syntax\|Xpath expression]]~~</var>~~ that results in a <var>nodelist</var>. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|Xpath expression]] that results in a <var>nodelist</var>. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).
	<p>Prior to <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>		<p>Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</p></td></tr>
	</table>		</table>

Line 99:		Line 99:
	<ul>		<ul>
	<li>To select a single node, use <var>[[SelectSingleNode (XmlDoc/XmlNode function)\|SelectSingleNode]]</var>, which stops after selecting a single node.		<li>To select a single node, use <var>[[SelectSingleNode (XmlDoc/XmlNode function)\|SelectSingleNode]]</var>, which stops after selecting a single node.
	<li>For more information about using XPath expressions, see [[XPath]].		<li>For more information about using XPath expressions, see [[XPath\|"XPath"]].
	</ul>		</ul>
	{{Template:XmlDoc/XmlNode:SelectNodes footer}}		{{Template:XmlDoc/XmlNode:SelectNodes footer}}

Goff: edits, tags and links

2011-05-22T09:41:28Z

edits, tags and links

Show changes

Goff: xpath expression

2011-05-22T09:22:03Z

xpath expression

New page

{{Template:XmlDoc/XmlNode:SelectNodes subtitle}}

This function stores in an <var>XmlNodelist</var> the list of nodes selected by an <var>[[XPath#XPath_syntax|Xpath expression]]</var>.

==Syntax==
{{Template:XmlDoc/XmlNode:SelectNodes syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%nodl</th>
<td>An <var>XmlNodelist</var> that is set to point to the nodelist that is created. </td></tr>
<tr><th>nr</th>
<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the <var class="term">xpath</var> expression. If an <var>XmlDoc</var>, the Root node is the context node. </td></tr>
<tr><th>xpath</th>
<td>A <var>Unicode</var> string that is an <var>[[XPath#XPath_syntax|Xpath expression]]</var> that results in a nodelist. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose 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.</td></tr>

</table>

==Usage notes==
<ul>
<li>If the result of the argument XPath expression (XPath) is empty,
Null is returned.
<li>The nodes found by <var>SelectNodes</var> are arranged in the resulting nodelist
in document order.
For some sets selected by XPath expressions
(for example, the set of ancestor nodes),
document order may not be the ordering you intuitively expect.
For a discussion of this issue, see [[??]] refid=docord..
</ul>

==Examples==
<ul>
<li>In the following example, <var>SelectNodes</var> creates an <var>XmlNodelist</var>, from which an
element is selected to insert an element before:
Begin
%doc is Object XmlDoc
%nl1 is Object XmlNodelist
%n1 is Object XmlNode
%n2 is Object XmlNode
%doc = New
%doc:LoadXml(-
'<top> <a>a1</a> <a>a2</a> <a>a3</a> </top>')
%nl1 = %doc:SelectNodes('/top/a')
%n1 = %nl1:item(2)
%n2 = %n1:InsertElementBefore('a', 'a1.5')
Call %doc:Print
End


The example result follows:
<top>
<a>a1</a>
<a>a1.5</a>
<a>a2</a>
<a>a3</a>
</top>

<li>In the following example, <var>SelectNodes</var> creates two <var>XmlNodelist</var>s,
and the nodes in the difference between those nodelists are printed:
Begin
%doc is Object XmlDoc
%n1 is Object XmlNode
%nl1 is Object XmlNodelist
%nl2 is Object XmlNodelist
%nl3 is Object XmlNodelist
%i is Float
%doc = New
%doc:LoadXml('<top><a><a1/></a><a><a2/></a><a><a3/></a></top>')
Call %doc:Print
%nl1 = %doc:SelectNodes('/following::node()')
Print %nl1:Count
%nl2 = %doc:SelectNodes('/top/a')
Print %nl2:Count
%nl3 = %nl1:Difference(%nl2)
For %i from 1 to %nl3:Count
%n1 = %nl3:Item(%i)
Print %n1:qName
End For
End


The example result follows:
<top>
<a>
<a1/>
</a>
<a>
<a2/>
</a>
<a>
<a3/>
</a>
</top>
7
3
top
a1
a2
a3

</ul>

==Request-Cancellation Errors==
<ul>
<li>XPath is invalid.
<li>Insufficient free space exists in CCATEMP.
</ul>

==See also==
{{Template:XmlDoc/XmlNode:SelectNodes footer}}

<ul>
<li>To select a single node, use
??[[SelectSingleNode (XmlDoc/XmlNode function)|SelectSingleNode]], which stops
after selecting a single node.
<li>For more information about using XPath expressions, see [[XPath]].
</ul>

Wiccan: 1 revision

2011-02-08T16:34:09Z

1 revision

← Older revision	Revision as of 16:34, 8 February 2011
(No difference)

Dme: /* Examples */

2011-02-08T16:34:08Z

Examples

← Older revision		Revision as of 16:34, 8 February 2011
Line 13:		Line 13:
	<tr><th>XPath</th>		<tr><th>XPath</th>
	<td>A <var>Unicode</var> string that is an XPath expression that results in a nodelist. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (.), that is, the node referenced by the method object (<i>nr</i>).		<td>A <var>Unicode</var> string that is an XPath expression that results in a nodelist. The method returns these nodes in an <var>XmlNodelist</var>. This is an optional argument whose default is a period (.), that is, the node referenced by the method object (<i>nr</i>).
	~~<p class="code">~~Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr>
	~~</p>~~		Prior to ''Sirius Mods'' version 7.6, this is an EBCDIC string.</td></tr>

	</table>		</table>