13 C用のXPath APIパッケージ

XPathメソッドは、XPathに関連のある型およびインタフェースを処理します。

この章の内容は次のとおりです。

• XPathインタフェース

関連項目: 『Oracle XML Developer's Kitプログラマーズ・ガイド』 『Oracle XML DB開発者ガイド』

---

XPathインタフェース

表13-1に、XPathインタフェースで使用できるメソッドの概要を示しています。

表13-1 XPathメソッドの概要

関数	概要
XmlXPathCreateCtx()	XPathコンテキストを作成します。
XmlXPathDestroyCtx()	XPathコンテキストを破棄します。
XmlXPathEval()	XPath式を評価します。
XmlXPathGetObjectBoolean()	XPathオブジェクトのブール値を取得します。
XmlXPathGetObjectFragment()	XPathオブジェクトのフラグメント値を取得します。
XmlXPathGetObjectNSetNode()	ノードセット型XPathオブジェクトからノードを取得します。
XmlXPathGetObjectNSetNum()	ノードセット型XPathオブジェクトからノードの数を取得します。
XmlXPathGetObjectNumber()	XPathオブジェクトから数値を取得します。
XmlXPathGetObjectString()	XPathオブジェクトから文字列を取得します。
XmlXPathGetObjectType()	XPathオブジェクトの型を取得します。
XmlXPathParse()	XPath式を解析します。

---

XmlXPathCreateCtx()

XPathコンテキストを作成します。

構文

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

パラメータ	IN/OUT	説明
xsl	IN	xmldocオブジェクトとしてのXSLスタイルシート
baseuri	IN	ドキュメントで使用されているベースURI(存在する場合)
ctxnode	IN	現在のコンテキストの位置
ctxpos	IN	現在のコンテキストのサイズ
ctxsize	IN	現在のコンテキスト・ノード

戻り値

(xpctx *) XPathコンテキスト。エラー発生時にはNULLが戻されます。

---

XmlXPathDestroyCtx()

XPathコンテキストを破棄します。

構文

void XmlXPathDestroyCtx(
   xpctx *xslxpctx);

パラメータ	IN/OUT	説明
xslxpctx	IN	XPathコンテキスト・オブジェクト

---

XmlXPathEval()

XPath式を評価します。

構文

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

パラメータ	IN/OUT	説明
xctx	IN	XPathコンテキスト
exprtree	IN	解析したXPath式ツリー
err	OUT	エラー・コード

戻り値

(xpobj *) 結果のXPathオブジェクト。エラー発生時にはNULLが戻されます。

---

XmlXPathGetObjectBoolean()

XPathオブジェクトのブール値を取得します。

構文

boolean XmlXPathGetObjectBoolean(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(boolean) 真理値。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectFragment()

XPathオブジェクトのブール値を取得します。

構文

xmlnode* XmlXPathGetObjectFragment(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(boolean) 真理値。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectNSetNode()

ノードセット型XPathオブジェクトからノードを取得します。

構文

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

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト
i	IN	ノードセットのノードのインデックス

戻り値

(xmlnode *) オブジェクト型または値。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectNSetNum()

ノードセット型XPathオブジェクトからノードの数を取得します。

構文

ub4 XmlXPathGetObjectNSetNum(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(ub4) ノードセット内のノードの数。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectNumber()

XPathオブジェクトから数値を取得します。

構文

double XmlXPathGetObjectNumber(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(double) 数値。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectString()

XPathオブジェクトから文字列を取得します。

構文

oratext *XmlXPathGetObjectString(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(oratext *) 文字列。

関連項目: XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathGetObjectType()

XPathオブジェクト型を取得します。

構文

xmlxslobjtype XmlXPathGetObjectType(
   xpobj *obj);

パラメータ	IN/OUT	説明
obj	IN	XPathオブジェクト

戻り値

(xmlxslobjtype) オブジェクトの型コード。

関連項目: XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

---

XmlXPathParse()

XPath式を解析します。

構文

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

パラメータ	IN/OUT	説明
xctx	IN	XPathコンテキスト・オブジェクト
expr	IN	XPath式
err	OUT	エラー・コード

戻り値

(xpexpr *) XPath式解析ツリー。エラー発生時にはNULLが戻されます。