Skip Headers

Oracle® XML API Reference 10g Release 1 (10.1) Part No. B10789-01 |
| Contents

## NodeFilter Interface

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.

### XMLDOM_ACCEPT_NODE_F

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.

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