13 XML C用のXPath APIパッケージ
XPathメソッドは、XPathに関連のある型およびインタフェースを処理します。
次の表にXML C APIのXPath
パッケージで使用できるメソッドの概要を示します。
表13-1 XML C実装のXPathメソッドの概要
関数 | 概要 |
---|---|
XPathコンテキストを作成します。 |
|
XPathコンテキストを破棄します。 |
|
XPath式を評価します。 |
|
XPathオブジェクトのブール値を取得します。 |
|
XPathオブジェクトのフラグメント値を取得します。 |
|
ノードセット型XPathオブジェクトからノードを取得します。 |
|
ノードセット型XPathオブジェクトからノードの数を取得します。 |
|
XPathオブジェクトから数値を取得します。 |
|
XPathオブジェクトから文字列を取得します。 |
|
XPathオブジェクトの型を取得します。 |
|
XPath式を解析します。 |
13.1 XmlXPathCreateCtx()
XPath
コンテキストを作成します。
構文
xpctx* XmlXPathCreateCtx( xmlctx *xsl, oratext *baseuri, xmlnode *ctxnode, ub4 ctxpos, ub4 ctxsize);
パラメータ | In/Out | 説明 |
---|---|---|
xsl |
IN |
|
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 |
|
exprtree |
IN |
解析した |
err |
OUT |
エラー・コード |
戻り値
(xpobj *)
結果のXPathオブジェクト。エラー発生時にはNULL
が戻されます。
13.4 XmlXPathGetObjectBoolean()
XPath
オブジェクトのブール値を取得します。
構文
boolean XmlXPathGetObjectBoolean( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
13.5 XmlXPathGetObjectFragment()
XPath
オブジェクトのブール値を取得します。
構文
xmlnode* XmlXPathGetObjectFragment( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
|
戻り値
13.6 XmlXPathGetObjectNSetNode()
ノードセット型XPathオブジェクトからノードを取得します。
構文
xmlnode *XmlXPathGetObjectNSetNode( xpobj *obj, ub4 i);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
|
i |
IN |
ノードセットのノードのインデックス |
戻り値
(xmlnode *)
オブジェクト型または値。
13.7 XmlXPathGetObjectNSetNum()
ノードセット型XPath
オブジェクトからノードの数を取得します。
構文
ub4 XmlXPathGetObjectNSetNum( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
|
戻り値
13.8 XmlXPathGetObjectNumber()
XPathオブジェクトから数値を取得します。
構文
double XmlXPathGetObjectNumber( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
|
戻り値
13.9 XmlXPathGetObjectString()
XPath
オブジェクトから文字列を取得します。
構文
oratext *XmlXPathGetObjectString( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
13.10 XmlXPathGetObjectType()
XPath
オブジェクト型を取得します。
構文
xmlxslobjtype XmlXPathGetObjectType( xpobj *obj);
パラメータ | In/Out | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
(xmlxslobjtype)
オブジェクトの型コード。