Difference (XmlNodelist function)
Difference between XmlNodelists
Difference is a member of the XmlNodelist class.
This function creates an XmlNodelist that is the difference of (that is, it removes nodes from) one XmlNodelist and another.
Syntax
%nlis = inNlis:Difference(inNlis2)
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