Difference (XmlNodelist function): Difference between revisions
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 | <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 | <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- | ==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
- The following example will create an empty XmlNodelist:
%empty = %nlis:Difference(%nlis)
- 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.