Skip Headers

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

## XPtrLocSet Interface

Table 11-3 summarizes the methods of available through the `XPtrLocSet` interface.

Table 11-3 Summary of XPtrLocSet Methods; Package XPointer

Function | Summary
--- | ---
XmlXPtrLocSetFree | Free a location set
XmlXPtrLocSetGetItem | Returns location with `idx` position in `XPtrLocSet`
XmlXPtrLocSetGetLength | Returns length of `XPtrLocSet`.

### XmlXPtrLocSetFree

It is user's responsibility to call this function on every location set returned by `XPointer` or `XPtrLocSet` interfaces

Syntax

    void XmlXPtrLocSetFree(
       xmlxptrlocset* locset);

Parameter | In/Out | Description
--- | --- | ---
    locset
    IN
| location set

### XmlXPtrLocSetGetItem

Returns location with idx position in the location set. First position is `1`.

Syntax

    xmlxptrloc* XmlXPtrLocSetGetItem(
       xmlxptrlocset* locset,
       ub4 idx);

Parameter | In/Out | Description
--- | --- | ---
    locset
    IN
| location set
    idx
    IN
| location index

Returns

`(xmlxptrloc *)` location with the position `idx`

### XmlXPtrLocSetGetLength

Returns the number of locations in the location set

Syntax

    ub4 XmlXPtrLocSetGetLength(
       xmlxptrlocset* locset);

Parameter | In/Out | Description
--- | --- | ---
    locset
    IN
| location set

Returns

`(ub4)` number of nodes in `locset`