InsertSubtreeBefore (XmlNode function) - Revision history

JAL: /* Request-cancellation errors */

2014-03-03T17:32:50Z

Request-cancellation errors

← Older revision		Revision as of 17:32, 3 March 2014
Line 170:		Line 170:

	==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>Object <var class="term">nod</var> is the <var>Root</var> node.		<li>Object <var class="term">nod</var> is the <var>Root</var> node.

	<li>The <var class="term">sourceSubtreeNode</var> argument is a <var>Root</var> node.		<li>The <var class="term">sourceSubtreeNode</var> argument is a <var>Root</var> node.

	<li><var class="term">nod</var> is the same as, or a descendant of, <var class="term">sourceSubtreeNode</var>.		<li><var class="term">nod</var> is the same as, or a descendant of, <var class="term">sourceSubtreeNode</var>.

	<li>Source and target <var>XmlDoc</var>s have different <var>Namespace</var> settings.		<li>Source and target <var>XmlDoc</var>s have different <var>Namespace</var> settings.

	<li>Any of the errors which would occur based on insertion of the top subtree node at the given target parent: for example,		<li>Any of the errors which would occur based on insertion of the top subtree node at the given target parent: for example,
	<ul>		<ul>
Line 182:		Line 187:
	</ul>		</ul>
	See the "Add" function corresponding to the type of the subtree node (for those examples just cited, <var>[[AddAttribute (XmlNode function)\|AddAttribute]]</var> and <var>[[AddText (XmlNode function)\|AddText]]</var>, respectively).		See the "Add" function corresponding to the type of the subtree node (for those examples just cited, <var>[[AddAttribute (XmlNode function)\|AddAttribute]]</var> and <var>[[AddText (XmlNode function)\|AddText]]</var>, respectively).

	<li>Insufficient free space exists in CCATEMP.		<li>Insufficient free space exists in CCATEMP.
	</ul>		</ul>

JAL at 00:25, 1 November 2012

2012-11-01T00:25:50Z

← Older revision		Revision as of 00:25, 1 November 2012
Line 1:		Line 1:
	{{Template:XmlNode:InsertSubtreeBefore subtitle}}		{{Template:XmlNode:InsertSubtreeBefore subtitle}}
	The <var>InsertSubtreeBefore</var> callable function inserts a copy of a '''subtree''' of an <var>XmlDoc</var> as the sibling immediately preceding the method <var>XmlNode</var>. A subtree is a node, all of its attributes and namespace declarations, and all descendants of the node and their attributes and namespace declarations.		The <var>InsertSubtreeBefore</var> [[Notation conventions for methods#Callable functions\|callable]] function inserts a copy of a '''subtree''' of an <var>XmlDoc</var> as the sibling immediately preceding the method <var>XmlNode</var>. A subtree is a node, all of its attributes and namespace declarations, and all descendants of the node and their attributes and namespace declarations.

	==Syntax==		==Syntax==

Dme at 00:42, 17 October 2012

2012-10-17T00:42:17Z

← Older revision		Revision as of 00:42, 17 October 2012
Line 27:		Line 27:
	<li>The source <var>XmlDoc</var> has <code>Namespace=None</code> and the target <var>XmlDoc</var> has <code>Namespace=On</code>, if the <var>DefaultURI</var> argument is specified.		<li>The source <var>XmlDoc</var> has <code>Namespace=None</code> and the target <var>XmlDoc</var> has <code>Namespace=On</code>, if the <var>DefaultURI</var> argument is specified.
	</ul>		</ul>
	<li>There is a very small "one-time" processing cost if [[XPath#~~perf~~\|certain Xpath expression]] operations are performed after using this method, because "Insert-Before" methods are guaranteed to add a node out of document order. In general, processing an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).		<li>There is a very small "one-time" processing cost if [[XPath#ordScan\|certain Xpath expression]] operations are performed after using this method, because "Insert-Before" methods are guaranteed to add a node out of document order. In general, processing an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).
	<li>A subtree that is a <var>Text</var> node may not be inserted adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.		<li>A subtree that is a <var>Text</var> node may not be inserted adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.
	<li>A node that is added to an <var>XmlDoc</var> whose <var>[[AllowNull (XmlDoc property)\|AllowNull]]</var> property setting is <code>True</code>, may not later be the source node of a subtree to be inserted into a target <var>XmlDoc</var> in which <code>AllowNull=False</code>.		<li>A node that is added to an <var>XmlDoc</var> whose <var>[[AllowNull (XmlDoc property)\|AllowNull]]</var> property setting is <code>True</code>, may not later be the source node of a subtree to be inserted into a target <var>XmlDoc</var> in which <code>AllowNull=False</code>.

Dme at 00:34, 17 October 2012

2012-10-17T00:34:15Z

← Older revision		Revision as of 00:34, 17 October 2012
Line 27:		Line 27:
	<li>The source <var>XmlDoc</var> has <code>Namespace=None</code> and the target <var>XmlDoc</var> has <code>Namespace=On</code>, if the <var>DefaultURI</var> argument is specified.		<li>The source <var>XmlDoc</var> has <code>Namespace=None</code> and the target <var>XmlDoc</var> has <code>Namespace=On</code>, if the <var>DefaultURI</var> argument is specified.
	</ul>		</ul>
	<li>There is a very small "one-time" processing cost if ~~certain~~ [[XPath]] operations are performed after using this method, because "Insert-Before" methods are guaranteed to add a node out of document order. In general, processing an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).		<li>There is a very small "one-time" processing cost if [[XPath#perf\|certain Xpath expression]] operations are performed after using this method, because "Insert-Before" methods are guaranteed to add a node out of document order. In general, processing an <var>XmlDoc</var> is likely to be more efficient if you add nodes in document order (that is, top-to-bottom, left-to-right).
	<li>A subtree that is a <var>Text</var> node may not be inserted adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.		<li>A subtree that is a <var>Text</var> node may not be inserted adjacent to (that is, as a sibling of) another <var>Text</var> node, unless the <var>[[AdjacentText (XmlDoc property)\|AdjacentText]]</var> property setting is <code>Combine</code>.
	<li>A node that is added to an <var>XmlDoc</var> whose <var>[[AllowNull (XmlDoc property)\|AllowNull]]</var> property setting is <code>True</code>, may not later be the source node of a subtree to be inserted into a target <var>XmlDoc</var> in which <code>AllowNull=False</code>.		<li>A node that is added to an <var>XmlDoc</var> whose <var>[[AllowNull (XmlDoc property)\|AllowNull]]</var> property setting is <code>True</code>, may not later be the source node of a subtree to be inserted into a target <var>XmlDoc</var> in which <code>AllowNull=False</code>.

JAL2 at 21:26, 7 August 2012

2012-08-07T21:26:36Z

← Older revision		Revision as of 21:26, 7 August 2012
Line 14:		Line 14:
	<tr><th><var>DefaultURI</var></th>		<tr><th><var>DefaultURI</var></th>
	<td>Optional, but [[Methods#Named parameters\|name required]], <var>Unicode</var> string parameter that controls the URI of the default namespace of some of the <var>Element</var> nodes of the inserted subtree.		<td>Optional, but [[Methods#Named parameters\|name required]], <var>Unicode</var> string parameter that controls the URI of the default namespace of some of the <var>Element</var> nodes of the inserted subtree.
	<p>If a <var ~~class="term"~~>DefaultURI</var> argument is specified, its value is used as the URI that is used for all unprefixed elements in the inserted subtree that are not already in the scope of a default namespace declaration within the inserted subtree. For more details, see the [[#Usage_notes\|"Usage Notes"]] section, below.</p>		<p>If a <var>DefaultURI</var> argument is specified, its value is used as the URI that is used for all unprefixed elements in the inserted subtree that are not already in the scope of a default namespace declaration within the inserted subtree. For more details, see the [[#Usage_notes\|"Usage Notes"]] section, below.</p>
	<p>This parameter is available as of <var class="product">[[Sirius Mods]]</var> Version 6.9. Prior to <var class="product">Sirius Mods</var> Version 7.6, ''string'' is an EBCDIC string.</p></td></tr>		<p>This parameter is available as of <var class="product">[[Sirius Mods]]</var> Version 6.9. Prior to <var class="product">Sirius Mods</var> Version 7.6, ''string'' is an EBCDIC string.</p></td></tr>
	</table>		</table>

JAL2 at 23:51, 31 May 2011

2011-05-31T23:51:05Z

Show changes

Goff: finish it

2011-05-29T02:15:25Z

finish it

Show changes

Goff: /* See also */

2011-05-28T23:22:21Z

Goff: /* Request-Cancellation Errors */

2011-05-28T02:39:02Z

Request-Cancellation Errors

← Older revision		Revision as of 02:39, 28 May 2011
Line 186:		Line 186:
	<ul>		<ul>
	<li><var class="term">Nod</var> is the <var>Root</var> node.		<li><var class="term">Nod</var> is the <var>Root</var> node.
	<li><var class="term">sourceSubtreeNod</var> is a </var>Root</var> node.		<li><var class="term">sourceSubtreeNod</var> is a <var>Root</var> node.
	<li><var class="term">Nod</var> is the same as, or a descendant of, <var class="term">sourceSubtreeNod</var>.		<li><var class="term">Nod</var> is the same as, or a descendant of, <var class="term">sourceSubtreeNod</var>.
	<li>Source and target <var>XmlDoc</var>s have different Namespace settings.		<li>Source and target <var>XmlDoc</var>s have different Namespace settings.

Goff: move footer template to actual end; edits, tags and links

2011-05-28T02:38:37Z

move footer template to actual end; edits, tags and links

Show changes

← Older revision		Revision as of 23:22, 28 May 2011
Line 202:		Line 202:
	<ul>		<ul>
	<li><var>[[AddSubtree (XmlDoc/XmlNode function)\|AddSubtree]]</var> also copies a Subtree node. <var>InsertSubtreeBefore</var> copies a subtree as the immediately preceding sibling of the node pointed to by the method object; <var>AddSubtree</var> copies a subtree as the last child of the node pointed to by the method object.		<li><var>[[AddSubtree (XmlDoc/XmlNode function)\|AddSubtree]]</var> also copies a Subtree node. <var>InsertSubtreeBefore</var> copies a subtree as the immediately preceding sibling of the node pointed to by the method object; <var>AddSubtree</var> copies a subtree as the last child of the node pointed to by the method object.
	<li>For hints about inserting a node ''after'' a sibling node, see the <var>[[InsertElementBefore_(XmlNode_function)#Examples\|\|"Example section in InsertElementBefore"]]</var>.		<li>For hints about inserting a node ''after'' a sibling node, see the <var>[[InsertElementBefore_(XmlNode_function)#Examples\|"Example section in InsertElementBefore"]]</var>.
	</ul>		</ul>
	{{Template:XmlNode:InsertSubtreeBefore footer}}		{{Template:XmlNode:InsertSubtreeBefore footer}}