Table 8-2 summarizes the methods of available through the NodeFilte
r 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. NodeIterator
s 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.
#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 |
(xmlerr)
filtering result