NodeFilter Interface

Table 8-2 summarizes the methods of available through the NodeFilter interface.

Table 8-2 Summary of NodeFilter Methods; Traversal Package

Function	Summary
XMLDOM_ACCEPT_NODE_F	Perform user-defined filtering action on node.

Sole method of NodeFilter interface. Given a node and a filter, determines the filtering action to perform.

This function pointer is passed to the node iterator/tree walker methods, as needed.

Values for xmlerr are:

XMLERR_OK Accept the node. Navigation methods defined for NodeIterator or TreeWalker will return this node.
XMLERR_FILTER_REJECT Reject the node. Navigation methods defined for NodeIterator or TreeWalker will not return this node. For TreeWalker, the children of this node will also be rejected. NodeIterators treat this as a synonym for XMLDOM_FILTER_SKIP
XMLERR_FILTER_SKIP Skip this single node. Navigation methods defined for NodeIterator or TreeWalker will not return this node. For both NodeIterator and TreeWalker, the children of this node will still be considered.

Syntax

#define XMLDOM_ACCEPT_NODE_F(func, xctx, node)
xmlerr func(
   xmlctx *xctx,
   xmlnode *node)

Parameter	In/Out	Description
xctx	IN	XML context
node	IN	node to test

Returns

(xmlerr) filtering result