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

Part Number B16206-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
Feedback

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

9 Package XPointer APIs for C++

XPointer package contains XPointer processing related types and interfaces.

This chapter contains the following sections:


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 of 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 of 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 of 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 of 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