Thank you for your feedback!

PDF

- best for offline viewing and printing

ePub

- best for most mobile devices

Mobi

- best for Amazon Kindle devices

Share to:

13 Package XPath APIs for C

XPath methods process XPath related types and interfaces.

This chapter contains this section:

XPath Interface

See Also:

XPath Interface

Table 13-1 Opens a new window summarizes the methods available through the XPath interface.

Table 13-1 Summary of XPath Methods

Function	Summary
XmlXPathCreateCtx()	Create an XPath context.
XmlXPathDestroyCtx()	Destroy an XPath context.
XmlXPathEval()	Evaluate XPath expression.
XmlXPathGetObjectBoolean()	Get boolean value of XPath object.
XmlXPathGetObjectFragment()	Get fragment value of XPath object.
XmlXPathGetObjectNSetNode()	Get node from nodeset type XPath object.
XmlXPathGetObjectNSetNum()	Get number of nodes in nodeset type XPath object.
XmlXPathGetObjectNumber()	Get number from XPath object.
XmlXPathGetObjectString()	Get string from XPath object.
XmlXPathGetObjectType()	Get XPath object type.
XmlXPathParse()	Parse XPath expression.

XmlXPathCreateCtx()

Create an XPath context

Syntax

xpctx* XmlXPathCreateCtx(
   xmlctx *xsl,
   oratext *baseuri,
   xmlnode *ctxnode, 
   ub4 ctxpos, 
   ub4 ctxsize);

Parameter	In/Out	Description
xsl	IN	XSL stylesheet as `xmldoc` object
baseuri	IN	base URI used by document, if any
ctxnode	IN	current context position
ctxpos	IN	current context size
ctxsize	IN	current context node

Returns

(xpctx *) XPath context or NULL on error

XmlXPathDestroyCtx()

Destroy an XPath context.

Syntax

void XmlXPathDestroyCtx(
   xpctx *xslxpctx);

Parameter	In/Out	Description
xslxpctx	IN	XPath context object

XmlXPathEval()

Evaluate XPath expression.

Syntax

xpobj *XmlXPathEval(
   xpctx *xctx, 
   xpexpr *exprtree, 
   xmlerr *err);

Parameter	In/Out	Description
xctx	IN	`XPath` context
exprtree	IN	parsed `XPath` expression tree
err	OUT	error code

Returns

(xpobj *) result XPath object or NULL on error

XmlXPathGetObjectBoolean()

Get boolean value of XPath object

Syntax

boolean XmlXPathGetObjectBoolean(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	XPath object

Returns

(boolean) truth value

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectFragment()

Get boolean value of XPath object

Syntax

xmlnode* XmlXPathGetObjectFragment(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	`XPath` object

Returns

(boolean) truth value

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectNSetNode()

Get node from nodeset-type XPath object

Syntax

xmlnode *XmlXPathGetObjectNSetNode(
   xpobj *obj,
   ub4 i);

Parameter	In/Out	Description
obj	IN	`XPath` object
i	IN	node index in nodeset

Returns

(xmlnode *) The object type or values.

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectString() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectNSetNum()

Get number of nodes in nodeset-type XPath object

Syntax

ub4 XmlXPathGetObjectNSetNum(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	`XPath` object

Returns

(ub4) number of nodes in nodeset

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectString() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectNumber()

Get number from XPath object

Syntax

double XmlXPathGetObjectNumber(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	`XPath` object

Returns

(double) number

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectString() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectString()

Get string from XPath object

Syntax

oratext *XmlXPathGetObjectString(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	XPath object

Returns

(oratext *) string

See Also:

XmlXPathGetObjectType() Opens a new window

, XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathGetObjectType()

Get XPath object type

Syntax

xmlxslobjtype XmlXPathGetObjectType(
   xpobj *obj);

Parameter	In/Out	Description
obj	IN	XPath object

Returns

(xmlxslobjtype) type-code for object

See Also:

XmlXPathGetObjectNSetNum() Opens a new window

, XmlXPathGetObjectNSetNode() Opens a new window

, XmlXPathGetObjectString() Opens a new window

, XmlXPathGetObjectNumber() Opens a new window

, XmlXPathGetObjectBoolean() Opens a new window

XmlXPathParse()

Parse XPath expression.

Syntax

xpexpr* XmlXPathParse(
   xpctx *xctx,
   oratext *expr,
   xmlerr * err);

Parameter	In/Out	Description
xctx	IN	XPath context object
expr	IN	XPath expression
err	OUT	error code

Returns

(xpexpr *) XPath expression parse tree or NULL on error

Page 17 of 22