Print (XmlDoc/XmlNode subroutine) - Revision history

JAL: xpath arg

2015-02-18T17:26:21Z

xpath arg

← Older revision		Revision as of 17:26, 18 February 2015
Line 11:		Line 11:

	<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 head of which is the top of the subtree to print. 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 expression that results in a nodelist, the head of which is the top of the subtree to print. Any other nodes in the nodelist are ignored.
			<p>
			This is an optional argument, and its default is a period (<code>.</code>), that is, the node referenced by the method object (<var class="term">nr</var>).</p></td></tr>

	<tr><th>options</th>		<tr><th>options</th>
Line 102:		Line 104:
	==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]]. </li>
	~~<li>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]~~</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation.
	<li>~~See the description of [[XmlDoc_API_serialization_options#EBCDIC_serialization_of_untranslatable_Unicode_characters\|Unicode to EBCDIC conversion]] performed by <var>Print</var>.~~

	<li>For additional discussion about serialization, see [[XmlDoc API#Transport: receiving and sending XML\|Transport: receiving and sending XML]].</li>		<li>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation. </li>

			<li>See the description of [[XmlDoc_API_serialization_options#EBCDIC_serialization_of_untranslatable_Unicode_characters\|Unicode to EBCDIC conversion]] performed by <var>Print</var>. </li>

			<li>For additional discussion about serialization, see [[XmlDoc API#Transport: receiving and sending XML\|Transport: receiving and sending XML]]. </li>

	<li>Additional serializing methods include:		<li>Additional serializing methods include:
	<ul>		<ul>
	<li><var>[[WebSend (XmlDoc subroutine)\|WebSend]]</var>		<li><var>[[WebSend (XmlDoc subroutine)\|WebSend]]</var> </li>
	<li><var>[[AddXml (HttpRequest subroutine)\|AddXml]]</var> (<var>[[HttpRequest class\|HttpRequest]]</var> class)		<li><var>[[AddXml (HttpRequest subroutine)\|AddXml]]</var> (<var>[[HttpRequest class\|HttpRequest]]</var> class) </li>
	</ul>		</ul></li>
	</ul>		</ul>

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

JAL: /* Syntax terms */

2014-03-18T21:10:23Z

Syntax terms

← Older revision		Revision as of 21:10, 18 March 2014
Line 14:		Line 14:

	<tr><th>options</th>		<tr><th>options</th>
	<td>A blank delimited string that can contain one or more of the following options. <p class="note">'''Note:''' These options are described in greater detail in [[XmlDoc API serialization options~~\|"XmlDoc API serialization options"~~]]. </p>		<td>A blank delimited string that can contain one or more of the following options. <p class="note">'''Note:''' These options are described in greater detail in [[XmlDoc API serialization options]]. </p>
	<ul>		<ul>
	<li><b>AllowXmlDecl</b> or <b>NoXmlDecl</b><br>		<li><b>AllowXmlDecl</b> or <b>NoXmlDecl</b><br>

JAL: /* See also */

2014-03-13T20:45:05Z

JAL: /* Syntax terms */

2014-03-09T17:58:33Z

Syntax terms

← Older revision		Revision as of 17:58, 9 March 2014
Line 29:		Line 29:

	<li><b>NoEmptyElt</b><br>		<li><b>NoEmptyElt</b><br>
	This deprecated option serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>). It is deprecated in order to deter users from using ~~the <var>NoEmptyElt</var> option~~ to serialize HTML: The recommended approach for HTML is shown on the <var>[[NoEmptyElement (XmlNode property)#browserExample\|NoEmptyElement]]</var> property page — some tags (<code><div></code>) <b>require</b> separate start and end tags, while other tags (<code><br></code>) <b>do not allow</b> separate start and end tags.		This deprecated option serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>).
			<p>
			<var>NoEmptyElt</var> is deprecated in order to deter users from using it to serialize HTML: The recommended approach for HTML is shown on the <var>[[NoEmptyElement (XmlNode property)#browserExample\|NoEmptyElement]]</var> property page — some tags (<code><div></code>) <b>require</b> separate start and end tags, while other tags (<code><br></code>) <b>do not allow</b> separate start and end tags. </p></li>

	<li><b>OmitNullElement</b><br>		<li><b>OmitNullElement</b><br>

JAL at 17:37, 9 March 2014

2014-03-09T17:37:55Z

← Older revision		Revision as of 17:37, 9 March 2014
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:XmlDoc/XmlNode:Print syntax}}		{{Template:XmlDoc/XmlNode:Print syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>nr</th>		<tr><th>nr</th>
	<td>An <var>XmlDoc</var> or <var>XmlNode</var>, used as the context node for the [[XPath#XPath_syntax\|XPath 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#XPath_syntax\|XPath 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 expression that results in a nodelist, the head of which is the top of the subtree to print. 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 expression that results in a nodelist, the head of which is the top of the subtree to print. 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>

	<tr><th>options</th>		<tr><th>options</th>
	<td>A blank delimited string that can contain one or more of the following options. <br>'''Note:''' These options are described in greater detail in [[XmlDoc API serialization options\|"XmlDoc API serialization options"]].		<td>A blank delimited string that can contain one or more of the following options. <p class="note">'''Note:''' These options are described in greater detail in [[XmlDoc API serialization options\|"XmlDoc API serialization options"]]. </p>
	<ul>		<ul>
	<li><b>AllowXmlDecl</b> or <b>NoXmlDecl</b><br>		<li><b>AllowXmlDecl</b> or <b>NoXmlDecl</b><br>
Line 26:		Line 29:

	<li><b>NoEmptyElt</b><br>		<li><b>NoEmptyElt</b><br>
	This deprecated option serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>). It is deprecated ~~because some~~ users ~~may try to use~~ the <~~code~~>NoEmptyElt</~~code~~> option to serialize HTML. The recommended approach is shown ~~for~~ the <var>[[NoEmptyElement (XmlNode property)#browserExample\|NoEmptyElement]]</var> property — some tags (<code><div></code>) <b>require</b> separate start and end tags, while other tags (<code><br></code>) <b>do not allow</b> separate start and end tags.		This deprecated option serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>). It is deprecated in order to deter users from using the <var>NoEmptyElt</var> option to serialize HTML: The recommended approach for HTML is shown on the <var>[[NoEmptyElement (XmlNode property)#browserExample\|NoEmptyElement]]</var> property page — some tags (<code><div></code>) <b>require</b> separate start and end tags, while other tags (<code><br></code>) <b>do not allow</b> separate start and end tags.

	<li><b>OmitNullElement</b><br>		<li><b>OmitNullElement</b><br>

Dme: /* Syntax terms */

2014-03-07T15:21:12Z

Syntax terms

← Older revision		Revision as of 15:21, 7 March 2014
Line 26:		Line 26:

	<li><b>NoEmptyElt</b><br>		<li><b>NoEmptyElt</b><br>
	~~Deprecated as of <var class="product">[[Sirius Mods]]</var> Version 7.0,~~ serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>).		This deprecated option serializes all empty elements with a start tag followed by an end tag. The default is to serialize an empty element with an empty element tag (as in <code><middleName/></code>). It is deprecated because some users may try to use the <code>NoEmptyElt</code> option to serialize HTML. The recommended approach is shown for the <var>[[NoEmptyElement (XmlNode property)#browserExample\|NoEmptyElement]]</var> property — some tags (<code><div></code>) <b>require</b> separate start and end tags, while other tags (<code><br></code>) <b>do not allow</b> separate start and end tags.

	<li><b>OmitNullElement</b><br>		<li><b>OmitNullElement</b><br>

JAL: /* Request-cancellation errors */

2014-03-03T20:59:47Z

Request-cancellation errors

← Older revision		Revision as of 20:59, 3 March 2014
Line 87:		Line 87:

	==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.

JAL2: /* Examples */

2012-03-20T21:51:03Z

Examples

← Older revision		Revision as of 21:51, 20 March 2012
Line 44:		Line 44:

	==Examples==		==Examples==
	In the following example, the <var>Print</var> method is called first in its default form with no arguments, then with explicit values for its options:		<ol>
			<li>In the following example, the <var>Print</var> method is called first in its default form with no arguments, then with explicit values for its options:
	<p class="code">begin		<p class="code">begin
	print 'Print method'		print 'Print method'
Line 76:		Line 77:
	</top></nowiki>		</top></nowiki>
	</p>		</p>
	In the following fragment, the <var>Print</var> result for a document with untranslatable Unicode is shown:		<li>In the following fragment, the <var>Print</var> result for a document with untranslatable Unicode is shown:
	<p class="code">%doc2:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('circumference', -		<p class="code">%doc2:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('circumference', '2 * &#x3C0; * r':U)
	'2 * &#x3C0; * r':U)
	%doc2:print		%doc2:print
	</p>		</p>
Line 84:		Line 84:
	<p class="output"><circumference>2 * &#x03C0; * r</circumference>		<p class="output"><circumference>2 * &#x03C0; * r</circumference>
	</p>		</p>
			</ol>

	==Request-cancellation errors==		==Request-cancellation errors==

Dme: /* Examples */

2012-02-02T19:08:37Z

Examples

← Older revision		Revision as of 19:08, 2 February 2012
Line 75:		Line 75:
	</a2>		</a2>
	</top></nowiki>		</top></nowiki>
			</p>
			In the following fragment, the <var>Print</var> result for a document with untranslatable Unicode is shown:
			<p class="code">%doc2:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('circumference', -
			'2 * &#x3C0; * r':U)
			%doc2:print
			</p>
			The result follows (the Unicode codepoint for the Greek letter π has the hexadecimal value 03C0):
			<p class="output"><circumference>2 * &#x03C0; * r</circumference>
	</p>		</p>

Dme: /* See also */

2012-02-02T16:45:24Z

← Older revision		Revision as of 16:45, 2 February 2012
Line 89:		Line 89:
	<li>For more information about using XPath expressions, see [[XPath\|"XPath"]].		<li>For more information about using XPath expressions, see [[XPath\|"XPath"]].
	<li>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation.		<li>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation.
			<li>See the description of [[XmlDoc_API_serialization_options#EBCDIC_serialization_of_untranslatable_Unicode_characters\|Unicode to EBCDIC conversion]] performed by <var>Print</var>.

	<li>Additional serializing methods include:		<li>Additional serializing methods include:
	<ul>		<ul>

← Older revision		Revision as of 20:45, 13 March 2014
Line 102:		Line 102:
	==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>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation.		<li>To more accurately serialize an <var>XmlDoc</var>, as opposed to providing a "displayable" form, use the <var>[[Serial (XmlDoc/XmlNode function)\|Serial]]</var> function. The <var>Print</var> subroutine, like its analogs <var>[[Audit (XmlDoc/XmlNode subroutine)\|Audit]]</var> and <var>[[Trace (XmlDoc/XmlNode subroutine)\|Trace]]</var>, inserts line breaks and performs indentation.
	<li>See the description of [[XmlDoc_API_serialization_options#EBCDIC_serialization_of_untranslatable_Unicode_characters\|Unicode to EBCDIC conversion]] performed by <var>Print</var>.		<li>See the description of [[XmlDoc_API_serialization_options#EBCDIC_serialization_of_untranslatable_Unicode_characters\|Unicode to EBCDIC conversion]] performed by <var>Print</var>.

			<li>For additional discussion about serialization, see [[XmlDoc API#Transport: receiving and sending XML\|Transport: receiving and sending XML]].</li>

	<li>Additional serializing methods include:		<li>Additional serializing methods include: