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