XPathメソッドは、XPathに関連のある型およびインタフェースを処理します。
この章の内容は次のとおりです。
関連項目:
|
表12-1に、XPath
インタフェースで使用できるメソッドの概要を示しています。
表12-1 XPathメソッドの概要
関数 | 概要 |
---|---|
|
XPathコンテキストを作成します。 |
|
XPathコンテキストを破棄します。 |
|
XPath式を評価します。 |
|
XPathオブジェクトのブール値を取得します。 |
|
XPathオブジェクトのフラグメント値を取得します。 |
|
ノードセット型XPathオブジェクトからノードを取得します。 |
|
ノードセット型XPathオブジェクトからノードの数を取得します。 |
|
XPathオブジェクトから数値を取得します。 |
|
XPathオブジェクトから文字列を取得します。 |
|
XPathオブジェクトの型を取得します。 |
|
XPath式を解析します。 |
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
が戻されます。
XPathコンテキストを破棄します。
構文
void XmlXPathDestroyCtx( xpctx *xslxpctx);
パラメータ | IN/OUT | 説明 |
---|---|---|
xslxpctx |
IN |
XPathコンテキスト・オブジェクト |
XPath
式を評価します。
構文
xpobj *XmlXPathEval( xpctx *xctx, xpexpr *exprtree, xmlerr *err);
パラメータ | IN/OUT | 説明 |
---|---|---|
xctx |
IN |
XPath コンテキスト |
exprtree |
IN |
解析したXPath 式ツリー |
err |
OUT |
エラー・コード |
戻り値
(xpobj *)
結果のXPathオブジェクト。エラー発生時にはNULL
が戻されます。
XPath
オブジェクトのブール値を取得します。
構文
boolean XmlXPathGetObjectBoolean( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
(boolean)
真理値。
XPath
オブジェクトのブール値を取得します。
構文
xmlnode* XmlXPathGetObjectFragment( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPath オブジェクト |
戻り値
(boolean)
真理値。
ノードセット型XPathオブジェクトからノードを取得します。
構文
xmlnode *XmlXPathGetObjectNSetNode( xpobj *obj, ub4 i);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPath オブジェクト |
i |
IN |
ノードセットのノードのインデックス |
戻り値
(xmlnode *)
オブジェクト型または値。
ノードセット型XPath
オブジェクトからノードの数を取得します。
構文
ub4 XmlXPathGetObjectNSetNum( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPath オブジェクト |
戻り値
(ub4)
ノードセット内のノードの数。
XPathオブジェクトから数値を取得します。
構文
double XmlXPathGetObjectNumber( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPath オブジェクト |
戻り値
(double)
数値。
XPath
オブジェクトから文字列を取得します。
構文
oratext *XmlXPathGetObjectString( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
(oratext *)
文字列。
XPath
オブジェクト型を取得します。
構文
xmlxslobjtype XmlXPathGetObjectType( xpobj *obj);
パラメータ | IN/OUT | 説明 |
---|---|---|
obj |
IN |
XPathオブジェクト |
戻り値
(xmlxslobjtype)
オブジェクトの型コード。
XPath
式を解析します。
構文
xpexpr* XmlXPathParse( xpctx *xctx, oratext *expr, xmlerr * err);
パラメータ | IN/OUT | 説明 |
---|---|---|
xctx |
IN |
XPathコンテキスト・オブジェクト |
expr |
IN |
XPath式 |
err |
OUT |
エラー・コード |
戻り値
(xpexpr *)
XPath
式解析ツリー。エラー発生時にはNULL
が戻されます。