Difference (XmlNodelist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (edits, tags and links)
 
mNo edit summary
Line 4: Line 4:
==Syntax==
==Syntax==
{{Template:XmlNodelist:Difference syntax}}
{{Template:XmlNodelist:Difference syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%diffNodl</th>
<tr><th>%diffNodl</th>
<td>An <var>XmlNodelist</var> that is set to point to the <var>nodelist</var> that is created. </td></tr>
<td>An <var>XmlNodelist</var> that is set to point to the nodelist that is created. </td></tr>
<tr><th>nodl</th>
<tr><th>nodl</th>
<td>An <var>XmlNodelist</var>. </td></tr>
<td>An <var>XmlNodelist</var>. </td></tr>
<tr><th>removeNodl</th>
<tr><th>removeNodl</th>
<td>An <var>XmlNodelist</var>; nodes on this <var>nodelist</var> are removed from <var class="term">nodl</var> to create the result.</td></tr>
<td>An <var>XmlNodelist</var>; nodes on this nodelist are removed from <var class="term">nodl</var> to create the result.</td></tr>
</table>
</table>


==Usage notes==
==Usage notes==
<ul>
<ul>
<li><var>Difference</var> only affects the nodes created on <var class="term">diffNodl</var>; it does not modify the <var>XmlDoc</var>, <var class="term">nodl</var>, nor <var class="term">removeNodl</var>.
<li><var>Difference</var> only affects the nodes created on <var class="term">%diffNodl</var>; it does not modify the <var>XmlDoc</var>, <var class="term">nodl</var>, nor <var class="term">removeNodl</var>.
<li>The <var>XmlDoc</var> associated with <var class="term">nodl</var> and <var class="term">removeNodl</var> must be the same.
<li>The <var>XmlDoc</var> associated with <var class="term">nodl</var> and <var class="term">removeNodl</var> must be the same.
</ul>
</ul>
Line 27: Line 28:
</ol>
</ol>


==Request-Cancellation Errors==
==Request-cancellation errors==
<ul>
<ul>
<li>The <var>XmlDoc</var>s associated with <var class="term">nodl</var> and <var class="term">removeNodl</var> are not the same.
<li>The <var>XmlDoc</var>s associated with <var class="term">nodl</var> and <var class="term">removeNodl</var> are not the same.

Revision as of 21:41, 31 May 2011

Difference between XmlNodelists (XmlNodelist class)

Difference creates an XmlNodelist that is the difference of (that is, it removes nodes from) one XmlNodelist and another.

Syntax

%diffNodl = nodl:Difference( removeNodl)

Syntax terms

%diffNodl An XmlNodelist that is set to point to the nodelist that is created.
nodl An XmlNodelist.
removeNodl An XmlNodelist; nodes on this nodelist are removed from nodl to create the result.

Usage notes

  • Difference only affects the nodes created on %diffNodl; it does not modify the XmlDoc, nodl, nor removeNodl.
  • The XmlDoc associated with nodl and removeNodl must be the same.

Examples

  1. The following example will create an empty XmlNodelist:

    %empty = %nlis:Difference(%nlis)

  2. Another example that makes use of the Difference method is in the "Examples" section in SelectNodes

Request-cancellation errors

  • The XmlDocs associated with nodl and removeNodl are not the same.
  • Insufficient free space exists in CCATEMP.

See also