1. XML C APIリファレンス
  2. XML C用のXPath APIパッケージ

13 XML C用のXPath APIパッケージ

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

次の表にXML C APIのXPathパッケージで使用できるメソッドの概要を示します。

表13-1 XML C実装のXPathメソッドの概要

関数 概要

XmlXPathCreateCtx()

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

XmlXPathDestroyCtx()

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

XmlXPathEval()

XPath式を評価します。

XmlXPathGetObjectBoolean()

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

XmlXPathGetObjectFragment()

XPathオブジェクトのフラグメント値を取得します。

XmlXPathGetObjectNSetNode()

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

XmlXPathGetObjectNSetNum()

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

XmlXPathGetObjectNumber()

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

XmlXPathGetObjectString()

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

XmlXPathGetObjectType()

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

XmlXPathParse()

XPath式を解析します。

13.1 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が戻されます。

13.2 XmlXPathDestroyCtx()

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

構文

void XmlXPathDestroyCtx(
   xpctx *xslxpctx);
パラメータ In/Out 説明 
xslxpctx
 
IN

XPathコンテキスト・オブジェクト

13.3 XmlXPathEval()

XPath式を評価します。

構文

xpobj *XmlXPathEval(
   xpctx *xctx, 
   xpexpr *exprtree, 
   xmlerr *err);
パラメータ In/Out 説明 
xctx
 
IN

XPathコンテキスト 

exprtree
 
IN

解析したXPath式ツリー 

err
 
OUT

エラー・コード

戻り値

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

13.4 XmlXPathGetObjectBoolean()

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

構文

boolean XmlXPathGetObjectBoolean(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

(boolean) 真理値

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.5 XmlXPathGetObjectFragment()

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

構文

xmlnode* XmlXPathGetObjectFragment(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

(boolean) 真理値

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.6 XmlXPathGetObjectNSetNode()

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

構文

xmlnode *XmlXPathGetObjectNSetNode(
   xpobj *obj,
   ub4 i);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト 

i
 
IN

ノードセットのノードのインデックス

戻り値

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

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.7 XmlXPathGetObjectNSetNum()

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

構文

ub4 XmlXPathGetObjectNSetNum(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

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

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.8 XmlXPathGetObjectNumber()

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

構文

double XmlXPathGetObjectNumber(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

(double) 数値

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectBoolean()

13.9 XmlXPathGetObjectString()

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

構文

oratext *XmlXPathGetObjectString(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

(oratext *) 文字列

関連項目:

XmlXPathGetObjectType()、XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.10 XmlXPathGetObjectType()

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

構文

xmlxslobjtype XmlXPathGetObjectType(
   xpobj *obj);
パラメータ In/Out 説明 
obj
 
IN

XPathオブジェクト

戻り値

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

関連項目:

XmlXPathGetObjectNSetNum()、XmlXPathGetObjectNSetNode()、XmlXPathGetObjectString()、XmlXPathGetObjectNumber()、XmlXPathGetObjectBoolean()

13.11 XmlXPathParse()

XPath式を解析します。

構文

xpexpr* XmlXPathParse(
   xpctx *xctx,
   oratext *expr,
   xmlerr * err);
パラメータ In/Out 説明 
xctx
 
IN

XPathコンテキスト・オブジェクト

 
expr
 
IN

XPath式

 
err
 
OUT

エラー・コード

戻り値

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