URI (XmlDoc/XmlNode function) - Revision history

Mlarocca: /* Examples */

2016-05-04T19:22:36Z

Examples

← Older revision		Revision as of 19:22, 4 May 2016
Line 41:		Line 41:
	and the null string are printed:		and the null string are printed:
	<p class="code">begin		<p class="code">begin
	%d ~~oject~~ xmlDoc		%d object xmlDoc
	%d = new		%d = new
	%n1 object xmlNode		%n1 object xmlNode

JAL: xpath arg

2015-02-18T18:04:45Z

xpath arg

← Older revision		Revision as of 18:04, 18 February 2015
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:URI subtitle}}		{{Template:XmlDoc/XmlNode:URI subtitle}}
	<var>URI</var> returns the "Uniform Resource Identifier" (URI) associated with the name of the node ~~which~~ is the head of an [[XPath]] result.		<var>URI</var> returns the "Uniform Resource Identifier" (URI) associated with the name of the node that is the head of an [[XPath]] result.

	==Syntax==		==Syntax==
	{{Template:XmlDoc/XmlNode:URI syntax}}		{{Template:XmlDoc/XmlNode:URI syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%unicode</th>		<tr><th>%unicode</th>
	<td>A <var>Unicode</var> string variable for the returned URI. Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this variable is an EBCDIC string.</td></tr>		<td>A <var>Unicode</var> string variable for the returned URI. Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this variable is an EBCDIC string.</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 nodelist. The head of the nodelist is the node to process. An optional argument, its default is a period (<tt>.</tt>), that is, the node referenced by the method object <var class="term">nr</var>.</td></tr>		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The head of the nodelist is the node to process. Any other nodes in the nodelist are ignored.
			<p>
			This is an optional argument, and its default is a period (<tt>.</tt>), that is, the node referenced by the method object <var class="term">nr</var>.</p></td></tr>
	</table>		</table>

Line 22:		Line 27:
	<li>The null string, otherwise.		<li>The null string, otherwise.
	</ul>		</ul>

	<li><var>URI</var> may only be used if the <var>XmlDoc</var>'s <var>[[Namespace (XmlDoc property)\|Namespace]]</var> property is <var>On</var>.		<li><var>URI</var> may only be used if the <var>XmlDoc</var>'s <var>[[Namespace (XmlDoc property)\|Namespace]]</var> property is <var>On</var>.

	<li>Namespace-aware applications should use the namespace URI rather than the prefix to identify elements.		<li>Namespace-aware applications should use the namespace URI rather than the prefix to identify elements.

	<li>As of <var class="product">Sirius Mods</var> Version 7.3, the method's argument and result may include only non-null EBCDIC characters that translate to Unicode.		<li>As of <var class="product">Sirius Mods</var> Version 7.3, the method's argument and result may include only non-null EBCDIC characters that translate to Unicode.
	<p>As of <var class="product">Sirius Mods</var> Version 7.6, these strings are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].</p>		<p>
			As of <var class="product">Sirius Mods</var> Version 7.6, these strings are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|Strings and Unicode with the XmlDoc API]].</p>
	</ul>		</ul>

Line 58:		Line 67:
	==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>These methods also obtain information about the name of a node:		<li>These methods also obtain information about the name of a node:
	<ul>		<ul>
Line 66:		Line 75:
	</ul>		</ul>
	</ul>		</ul>

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

JAL: /* Request-cancellation errors */

2014-03-03T21:14:50Z

Request-cancellation errors

← Older revision		Revision as of 21:14, 3 March 2014
Line 48:		Line 48:

	==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>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.		<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.

JAL2 at 19:25, 6 June 2011

2011-06-06T19:25:55Z

← Older revision		Revision as of 19:25, 6 June 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:URI subtitle}}		{{Template:XmlDoc/XmlNode:URI subtitle}}
	<var>URI</var> returns the "Uniform Resource Identifier" (URI) associated with the name of the node which is the head of an ~~<var>~~[[XPath]]~~</var>~~ result.		<var>URI</var> returns the "Uniform Resource Identifier" (URI) associated with the name of the node which is the head of an [[XPath]] result.

	==Syntax==		==Syntax==
Line 29:		Line 29:

	==Examples==		==Examples==
	In the following example, the ~~<var>~~URI~~</var>~~ of the first element		In the following example, the URI of the first element
	and the null string are printed:		and the null string are printed:
	<p class="code">begin		<p class="code">begin
Line 50:		Line 50:
	<ul>		<ul>
	<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.		<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.
	<li><var class="term">xpath</var> is invalid.		<li><var class="term">xpath</var> expression is invalid.
	<li>Result of (<var class="term">xpath</var>) is empty.		<li>Result of (<var class="term">xpath</var>) is empty.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.

JALWiccan: 1 revision

2011-06-06T19:05:50Z

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 47:		Line 47:
	</p>		</p>

	==Request-~~Cancellation Errors/~~==		==Request-cancellation errors==
	<ul>		<ul>
	<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.		<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.

JALWiccan: 1 revision

2011-06-06T17:44:04Z

1 revision

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

JAL2 at 17:44, 6 June 2011

2011-06-06T17:44:03Z

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

	==Request-Cancellation Errors==		==Request-Cancellation Errors/==
	<ul>		<ul>
	<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.		<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.

JAL2 at 22:39, 23 May 2011

2011-05-23T22:39:31Z

← Older revision		Revision as of 22:39, 23 May 2011
Line 1:		Line 1:
	{{Template:XmlDoc/XmlNode:URI subtitle}}		{{Template:XmlDoc/XmlNode:URI subtitle}}
	<var>URI</var> returns "Uniform Resource Identifier" (~~<var>~~URI~~</var>~~) associated with the name of the node which is the head of an <var>[[XPath]]</var> result.		<var>URI</var> returns the "Uniform Resource Identifier" (URI) associated with the name of the node which is the head of an <var>[[XPath]]</var> result.

	==Syntax==		==Syntax==
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%unicode</th>		<tr><th>%unicode</th>
	<td>A <var>Unicode</var> string variable for the returned ~~<var>~~URI~~</var>~~. Prior to <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 7.6, this variable is an EBCDIC string.</td></tr>		<td>A <var>Unicode</var> string variable for the returned URI. Prior to <var class="product">[[Sirius Mods]]</var> Version 7.6, this variable is an EBCDIC string.</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 Root 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> which~~ results in a nodelist, The head of the nodelist is the node to process. An optional argument, its default is a period (<~~code~~>.</~~code~~>), that is, the node referenced by the method object <var class="term">nr</var>.</td></tr>		<td>A <var>Unicode</var> string that is an [[XPath#XPath_syntax\|XPath expression]] that results in a nodelist. The head of the nodelist is the node to process. An optional argument, its default is a period (<tt>.</tt>), that is, the node referenced by the method object <var class="term">nr</var>.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>The Uniform Resource Identifier (~~<var>~~URI~~</var>~~) of a node is defined to be:		<li>The Uniform Resource Identifier (URI) of a node is defined to be:
	<ul>		<ul>
	<li>The ~~<var>~~URI~~</var>~~ of the namespace declaration in scope for the prefix of the element-type or attribute name if there is one.		<li>The URI of the namespace declaration in scope for the prefix of the element-type or attribute name if there is one.
	<li>The ~~<var>~~URI~~</var>~~ of the default namespace declaration in scope for an unprefix of element-type.		<li>The URI of the default namespace declaration in scope for an unprefix of element-type.
	<li>The null string, otherwise.		<li>The null string, otherwise.
	</ul>		</ul>
	<li><var>URI</var> may only be used if the <var>XmlDoc</var>'s Namespace property is <~~code~~>On</~~code~~>.		<li><var>URI</var> may only be used if the <var>XmlDoc</var>'s <var>[[Namespace (XmlDoc property)\|Namespace]]</var> property is <var>On</var>.
	<li>Namespace-aware applications should use the namespace ~~<var>~~URI~~</var>~~ rather than the prefix to identify elements.		<li>Namespace-aware applications should use the namespace URI rather than the prefix to identify elements.
	<li>As of <var class="product">~~[[Sirius Mods\|"~~Sirius Mods~~"]]~~</var> Version 7.3, the method's argument and result may include only non-null EBCDIC characters that translate to ~~<var>~~Unicode~~</var>~~.		<li>As of <var class="product">Sirius Mods</var> Version 7.3, the method's argument and result may include only non-null EBCDIC characters that translate to Unicode.
	<p>As of <var class="product">"Sirius Mods"</var> Version 7.6, these strings are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].</p>		<p>As of <var class="product">Sirius Mods</var> Version 7.6, these strings are <var>Unicode</var> or are converted to <var>Unicode</var>. For more information about the effects of this Version 7.6 change, see [[XmlDoc API#Strings and Unicode with the XmlDoc API\|"Strings and Unicode with the XmlDoc API"]].</p>
	</ul>		</ul>

	==Examples==		==Examples==
	~~<ol><li>~~
	In the following example, the <var>URI</var> of the first element		In the following example, the <var>URI</var> of the first element
	and the null string are printed:		and the null string are printed:
Line 46:		Line 45:
	<p class="output">URI = ftp:here		<p class="output">URI = ftp:here
	URI =		URI =
	</p~~></ol~~>		</p>

	==Request-Cancellation Errors==		==Request-Cancellation Errors==
	<ul>		<ul>
	<li><var>XmlDoc</var> Namespace property not <~~code~~>On</~~code~~>.		<li><var>XmlDoc</var> <var>Namespace</var> property value not <var>On</var>.
	<li><var class="term">~~XPath~~</var> is invalid.		<li><var class="term">xpath</var> is invalid.
	<li>Result of (<var class="term">~~XPath~~</var>) is empty.		<li>Result of (<var class="term">xpath</var>) is empty.
	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>
Line 58:		Line 57:
	==See also==		==See also==
	<ul>		<ul>
	<li>For more information about using XPath expressions, see [[XPath]].		<li>For more information about using XPath expressions, see [[XPath\|"XPath"]].
	<li>These methods also obtain information about the name of a node:		<li>These methods also obtain information about the name of a node:
	<ul>		<ul>

Goff: xpath expression

2011-05-22T09:25:37Z

xpath expression

← Older revision		Revision as of 09:25, 22 May 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 Root 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 Root 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]]</var> ~~expression~~ which results in a nodelist, The head of the nodelist is the node to process. An optional argument, its default is a period (<code>.</code>), that is, the node referenced by the method object <var class="term">nr</var>.</td></tr>		<td>A <var>Unicode</var> string that is an <var>[[XPath#XPath_syntax\|Xpath expression]]</var> which results in a nodelist, The head of the nodelist is the node to process. An optional argument, its default is a period (<code>.</code>), that is, the node referenced by the method object <var class="term">nr</var>.</td></tr>
	</table>		</table>