Skip Headers

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

## NodeList Interface

Table 4-9 summarizes the methods of available through the `NodeList` interface.

Table 4-9 Summary of NodeList Methods; DOM Package

Function | Summary
--- | ---
XmlDomFreeNodeList | Free a node list returned by XmlDomGetElemsByTag, and so on.
XmlDomGetNodeListItem | Return nth node in list.
XmlDomGetNodeListLength | Return length of node list.

### XmlDomFreeNodeList

Free a node list returned by `XmlDomGetElemsByTag` or related functions, releasing all resources associated with it. If given a node list that is part of the DOM proper (such as the children of a node), does nothing.

Syntax

    void XmlDomFreeNodeList(
       xmlctx *xctx,
       xmlnodelist *list)

Parameter | In/Out | Description
--- | --- | ---
    xctx
    IN
| XML context
    list
    IN
| `NodeList` to free

See Also: XmlDomGetElemsByTag, XmlDomGetElemsByTagNS, XmlDomGetChildrenByTag, XmlDomGetChildrenByTagNS

### XmlDomGetNodeListItem

Return nth node in a node list. The first item is index `0`.

Syntax

    xmlnode* XmlDomGetNodeListItem(
       xmlctx *xctx,
       xmlnodelist *list,
       ub4 index)

Parameter | In/Out | Description
--- | --- | ---
    xctx
    IN
| XML context
    list
    IN
| `NodeList`
    index
    IN
| index into `list`

Returns

`(xmlnode *)` node at the nth position in node list [or `NULL`]

See Also: XmlDomGetNodeListLength, XmlDomFreeNodeList

### XmlDomGetNodeListLength

Returns the number of nodes in a node list (its length). Note that nodes are referred to by index, so the range of valid indexes is `0` through `length-1`.

Syntax

    ub4 XmlDomGetNodeListLength(
       xmlctx *xctx,
       xmlnodelist *list)

Parameter | In/Out | Description
--- | --- | ---
    xctx
    IN
| XML context
    list
    IN
| `NodeList`

Returns

`(ub4)` number of nodes in node list

See Also: XmlDomGetNodeListItem, XmlDomFreeNodeList