Exists (XmlDoc/XmlNode function) - Revision history

ELowell: /* Syntax terms */

2015-09-02T21:16:41Z

Syntax terms

← Older revision		Revision as of 21:16, 2 September 2015
Line 7:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%boolean</th>		<tr><th nowrap>%boolean</th>
	<td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>Exists</var>.</td></tr>		<td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>Exists</var>.</td></tr>

JAL: minor cleanup

2015-02-18T17:33:25Z

minor cleanup

← Older revision		Revision as of 17:33, 18 February 2015
Line 14:		Line 14:

	<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 nodelist. The expression 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 expression default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).

	Prior to <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</td></tr>		Prior to <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</td></tr>
Line 22:		Line 22:
	<ul>		<ul>
	<li>If you are only checking for the existence of some nodes in the document, <var>Exists</var> is the most efficient method:		<li>If you are only checking for the existence of some nodes in the document, <var>Exists</var> is the most efficient method:
	<ul><li><var>[[SelectCount (XmlDoc/XmlNode function)\|SelectCount]]</var> has the relative disadvantage that it may continue to examine the <var>XmlDoc</var> tree after the first matching node is found.		<ul>
	<li><var>[[SelectSingleNode (XmlDoc/XmlNode function)\|SelectSingleNode]]</var> has a similar disadvantage: it may visit nodes in an order other than the document order, and, since it guarantees to return the first node in <var>XmlDoc</var> order, it may continue even after the first match is found.		<li><var>[[SelectCount (XmlDoc/XmlNode function)\|SelectCount]]</var> has the relative disadvantage that it may continue to examine the <var>XmlDoc</var> tree after the first matching node is found. </li>
	</ul></ul>
			<li><var>[[SelectSingleNode (XmlDoc/XmlNode function)\|SelectSingleNode]]</var> has a similar disadvantage: it may visit nodes in an order other than the document order, and, since it guarantees to return the first node in <var>XmlDoc</var> order, it may continue even after the first match is found. </li>
			</ul></li>
			</ul>

	==Examples==		==Examples==
Line 36:		Line 39:
	</p>		</p>
	The example results follow:		The example results follow:
	<p class="~~code~~">Root exist? True		<p class="output">Root exist? True
	Elem of empty doc exist? False		Elem of empty doc exist? False
	</p>		</p>
Line 43:		Line 46:
	This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.		This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.
	<ul>		<ul>
	<li><var class="term">xpath</var> is invalid.		<li><var class="term">xpath</var> is invalid.</li>
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.</li>
	</ul>		</ul>

	==See also==		==See also==
	<ul>		<ul>
	<li>For more information about using XPath expressions, see [[XPath~~\|"XPath"~~]].		<li>For more information about using XPath expressions, see [[XPath]].</li>
	</ul>		</ul>

	{{Template:XmlDoc/XmlNode:Exists footer}}		{{Template:XmlDoc/XmlNode:Exists footer}}

JAL: /* Request-cancellation errors */

2014-03-03T17:26:12Z

Request-cancellation errors

← Older revision		Revision as of 17:26, 3 March 2014
Line 41:		Line 41:

	==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><var class="term">xpath</var> is invalid.		<li><var class="term">xpath</var> is invalid.

JAL2 at 21:11, 7 August 2012

2012-08-07T21:11:16Z

← Older revision		Revision as of 21:11, 7 August 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:XmlDoc/XmlNode:Exists syntax}}		{{Template:XmlDoc/XmlNode:Exists syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%boolean</th>		<tr><th>%boolean</th>
	<td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>Exists</var>.</td></tr>		<td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>Exists</var>.</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 XPath expression, <var class="term">xpath</var>. 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 nodelist. The expression 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 expression default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).

JALWiccan: 1 revision

2011-06-06T19:05:49Z

1 revision

← Older revision	Revision as of 19:05, 6 June 2011
(No difference)

JALWiccan: 1 revision

2011-06-06T19:05:48Z

1 revision

← Older revision		Revision as of 19:05, 6 June 2011
Line 37:		Line 37:
	</p>		</p>

	==Request-~~Cancellation Errors/~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var class="term">xpath</var> is invalid.		<li><var class="term">xpath</var> is invalid.

JALWiccan: 1 revision

2011-06-06T17:44:04Z

1 revision

← Older revision	Revision as of 17:44, 6 June 2011
(No difference)

JALWiccan: 1 revision

2011-06-06T17:44:03Z

1 revision

← Older revision		Revision as of 17:44, 6 June 2011
Line 37:		Line 37:
	</p>		</p>

	==Request-Cancellation Errors==		==Request-Cancellation Errors/==
	<ul>		<ul>
	<li><var class="term">xpath</var> is invalid.		<li><var class="term">xpath</var> is invalid.

JALWiccan: 1 revision

2011-06-06T17:37:54Z

1 revision

← Older revision	Revision as of 17:37, 6 June 2011
(No difference)

JAL2 at 17:37, 6 June 2011

2011-06-06T17:37:53Z

← Older revision		Revision as of 17:37, 6 June 2011
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 expression 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 expression default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).

	Prior to <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</td></tr>		Prior to <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, this is an EBCDIC string.</td></tr>