Difference (XmlNodelist function)
Difference between XmlNodelists (XmlNodelist class)
This function 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
%nlis | An XmlNodelist that is set to point to the nodelist that is created. |
---|---|
inNlis | An XmlNodelist. |
inNlis2 | An XmlNodelist; nodes on this nodelist are removed from inNlis to create the result. |
Usage notes
- Difference only affects the nodes created on nlis; it does not modify the XmlDoc, inNlis, nor inNlis2.
- The XmlDoc associated with inNlis and nr must be the same.
Example
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 inNlis and inNlis2 are not the same.
- Insufficient free space exists in CCATEMP.
.if 1 = 0 .do
If you want to select nodes in a XmlDoc and remove them from a nodelist, see ?? refid=$xmrmv..
See also ?? refid=$xmplcl.. .do end