DeepCopy (XmlNode function): Difference between revisions
Jump to navigation
Jump to search
m (edits, tags and links) |
mNo edit summary |
||
| Line 2: | Line 2: | ||
<var>DeepCopy</var> returns an exact copy of an <var>XmlNode</var> method object. | <var>DeepCopy</var> returns an exact copy of an <var>XmlNode</var> method object. | ||
Since an <var>XmlNode</var> cannot exist without its underlying <var>XmlDoc</var>, an <var>XmlNode</var> is deep copyable only, and no Copy method exists for an <var>XmlNode</var>. For further information about copyability, see [[Copying objects|"Copying objects"]]. | Since an <var>XmlNode</var> cannot exist without its underlying <var>XmlDoc</var>, an <var>XmlNode</var> is deep copyable only, and no <var>Copy</var> method exists for an <var>XmlNode</var>. For further information about copyability, see [[Copying objects|"Copying objects"]]. | ||
==Syntax== | ==Syntax== | ||
| Line 9: | Line 9: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%outNod</th> | <tr><th>%outNod</th> | ||
<td>An <var> | <td>An <var>XmlNode</var> object variable to contain the deep copy of <var class="term">nod</var>. | ||
<tr><th>nod</th> | <tr><th>nod</th> | ||
<td>An <var> | <td>An <var>XmlNode</var> object expression, which may be <var>Null</var>.</td></tr> | ||
</table> | </table> | ||
| Line 17: | Line 17: | ||
<ul> | <ul> | ||
<li>The method object (<var class="term">nod</var>) may be <var>Null</var>. The output of a copy of a <var>Null</var> object is a <var>Null</var> object. | <li>The method object (<var class="term">nod</var>) may be <var>Null</var>. The output of a copy of a <var>Null</var> object is a <var>Null</var> object. | ||
<li><var> | <li><var>DeepCopy</var> copies the underlying <var>XmlDoc</var> and sets the output <var>XmlNode</var> to the node in the new <var>XmlDoc</var> that corresponds to the input <var>XmlNode</var>. | ||
</ul> | </ul> | ||
==See also== | ==See also== | ||
<ul><li>[[AddSubtree (XmlDoc/XmlNode function)|AddSubtree]] | <ul><li><var>[[AddSubtree (XmlDoc/XmlNode function)|AddSubtree]]</var> copies a specified <var>XmlNode</var>, appending it to the method object. | ||
</ul> | </ul> | ||
{{Template:XmlNode:DeepCopy footer}} | {{Template:XmlNode:DeepCopy footer}} | ||
Latest revision as of 21:17, 31 May 2011
Deep copy this node (XmlNode class)
DeepCopy returns an exact copy of an XmlNode method object.
Since an XmlNode cannot exist without its underlying XmlDoc, an XmlNode is deep copyable only, and no Copy method exists for an XmlNode. For further information about copyability, see "Copying objects".
Syntax
%outNod = nod:DeepCopy
Syntax terms
| %outNod | An XmlNode object variable to contain the deep copy of nod. |
|---|---|
| nod | An XmlNode object expression, which may be Null. |
Usage notes
- The method object (nod) may be Null. The output of a copy of a Null object is a Null object.
- DeepCopy copies the underlying XmlDoc and sets the output XmlNode to the node in the new XmlDoc that corresponds to the input XmlNode.
See also
- AddSubtree copies a specified XmlNode, appending it to the method object.