9 Package XPointer APIs for C++

XPointer package contains XPointer processing related types and interfaces.

This chapter contains the following sections:

XPointer Datatypes
Processor Interface
XppException Interface
XppLocation Interface
XppLocSet Interface

XPointer Datatypes

Table 9-1 summarizes the datatypes of the XPointer package.

Table 9-1 Summary of Datatypes; XPointer Package

Datatype	Description
XppExceptionCode	Defines XPath compiler identifiers.
XppPrIdType	Defines XPointer processor identifiers.
XppLocType	Defines location types for XPointer.

XppExceptionCode

XPointer related exception codes.

Definition

typedef enum XPathCompIdType {
   XvmXPathCompCXml = 1 
} XPathCompIdType;

XppPrIdType

Defines XPointer processor identifiers.

Definition

typedef enum XppPrIdType {   XPtrPrCXml         = 1} XppPrIdType;

XppLocType

Defines location types for XPointer.

Definition

typedef enum XppLocType {
      XPPLOC_TYPE_UNKNOWN = 0,
      XPPLOC_TYPE_NODE    = 1,
      XPPLOC_TYPE_POINT   = 2,
      XPPLOC_TYPE_RANGE   = 3,
      XPPLOC_TYPE_BOOL    = 4,
      XPPLOC_TYPE_NUM     = 5,
      XPPLOC_TYPE_STR     = 6
    } XppLocType;

Processor Interface

Table 9-2 summarizes the methods available through the Processor interface.

Table 9-2 Summary of Processor Methods; XPointer Package

Function	Summary
getProcessorId()	Get processor's Id.
process()	Evaluate XPointer expression against given document.

getProcessorId()

Get Processor Id.

Syntax

virtual XppPrIdType getProcessorId() const = 0;

Returns

(XppPrIdType) Processor's Id

process()

Evaluates XPointer expression against given document and returns result XPointer location set object.

Syntax

virtual XppLocSet< Node>* process (
   InputSource* isrc_ptr,
   oratext* xpp_exp)
throw (XppException) = 0;

Parameter	Description
isrc_ptr	instance document to process
xpp_exp	XPointer expression

Returns

(XppLocSet*) XPath object

XppException Interface

Table 9-3 summarizes the methods available through the XPPException interface.

Table 9-3 Summary of XppException Methods; Package XPointer

Function	Summary
getCode()	Get Oracle XML error code embedded in the exception.
getMesLang()	Get current language (encoding) of error messages.
getMesLang()	Get Oracle XML error message.
getXppCode()	Get XPointer exception code embedded in the exception.

getCode()

Virtual member function inherited from XmlException.

Syntax

virtual unsigned getCode() const = 0;

Returns

(unsigned) numeric error code (0 on success)

getMesLang()

Virtual member function inherited from XmlException.

Syntax

virtual oratext* getMesLang() const = 0;

Returns

(oratext*) Current language (encoding) of error messages

getMessage()

Virtual member function inherited from XmlException.

Syntax

virtual oratext* getMessage() const = 0;

Returns

(oratext *) Error message

getXppCode()

This is a virtual member function that defines a prototype for implementation defined member functions returning XPointer processor and compiler exception codes, defined in XppExceptionCode, of the exceptional situations during execution.

Syntax

virtual XppExceptionCode getXppCode() const = 0;

Returns

(XppExceptionCode) exception code

XppLocation Interface

Table 9-4 summarizes the methods available through the XppLocation interface.

Table 9-4 Summary of XppLocation Methods; XPointer Package

Function	Summary
getLocType()	Get the location type.
getNode()	Get the node.
getRange()	Get range.

getLocType()

Get the location type.

Syntax

 XppLocType getLocType() const;

getNode()

Get the node.

Syntax

 Node* getNode() const;

getRange()

Get range.

Syntax

 Range< Node>* getRange() const;

XppLocSet Interface

Table 9-5 summarizes the methods available through the XppLocSet interface.

Table 9-5 Summary of XppLocSet Methods; XPointer Package

Function	Summary
getItem()	Get item given its index.
getSize()	Get location set size.

getItem()

Returns a reference to the item.

Syntax

XppLocation< Node>* getItem(
   ub4 index) const;

Parameter	Description
index	index of an item

Returns

(XppLocation*) reference to the item

getSize()

The size of the node set.

Syntax

ub4 getSize() const;

Returns

(ub4) node set size