Difference (XmlNodelist function): Difference between revisions
Jump to navigation
Jump to search
m (edits, tags and links) |
|||
| (One intermediate revision by one other user not shown) | |||
| 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== | ||
This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling. | |||
<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. | ||
Latest revision as of 17:25, 3 March 2014
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
This list is not exhaustive: it does not include all the errors that are request cancelling.
- The XmlDocs associated with nodl and removeNodl are not the same.
- Insufficient free space exists in CCATEMP.