Skip Headers
Oracle® Database XML C API Reference
10g Release 2 (10.2)

Part Number B16207-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

11 Package XPointer APIs for C

Package XPointer contains APIs for three interfaces.

This chapter contains these sections:

See Also:


XPointer Interface

Table 11-1 summarizes the methods of available through the XPointer interface.

Table 11-1 Summary of XPointer Methods; Package XPointer

Function Summary
XmlXPointerEval()
Evaluates xpointer string.


XmlXPointerEval()

Parses and evaluates xpointer string and calculates locations in the document.

Syntax

xmlxptrlocset* XmlXPointerEval(
   xmldocnode* doc,
   oratext* xptrstr);
Parameter In/Out Description
doc
IN
document node of the corresponding DOM tree
xptrstr
IN
xpointer string

Returns

(xmlxptrlocset *) calculated location set


XPtrLoc Interface

Table 11-2 summarizes the methods of available through the XPtrLoc interface.

Table 11-2 Summary of XPtrLoc Methods; Package XPointer

Function Summary
XmlXPtrLocGetNode()
Returns Xml node from XPtrLoc.
XmlXPtrLocGetPoint()
Returns Xml point from XPtrLoc.
XmlXPtrLocGetRange()
Returns Xml range from XPtrLoc.
XmlXPtrLocGetType()
Returns type of XPtrLoc.
XmlXPtrLocToString()
Returns string for a location.


XmlXPtrLocGetNode()

Returns node from location

Syntax

xmlnode* XmlXPtrLocGetNode(
   xmlxptrloc* loc);
Parameter In/Out Description
loc
IN
location

Returns

(xmlnode *) Node from location


XmlXPtrLocGetPoint()

Returns point from location

Syntax

xmlpoint* XmlXPtrLocGetPoint(
   xmlxptrloc* loc);
Parameter In/Out Description
loc
IN
location

Returns

(xmlpoint *) Point from location


XmlXPtrLocGetRange()

Returns range from location.

Syntax

xmlrange* XmlXPtrLocGetRange(
   xmlxptrloc* loc);
Parameter In/Out Description
loc
IN
location

Returns

(xmlrange *) Range from location


XmlXPtrLocGetType()

Returns type of location

Syntax

xmlxptrloctype XmlXPtrLocGetType(
   xmlxptrloc* loc);
Parameter In/Out Description
loc
IN
location

Returns

(xmlxptrloctype) Type of location


XmlXPtrLocToString()

Returns string for a location:

- node name: name of the container node

- names of container nodes: "not a location" otherwise

Syntax

oratext* XmlXPtrLocToString(
   xmlxptrloc* loc);
Parameter In/Out Description
loc
IN
location

Returns

(oratext *) string


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