source: NonGTP/Xerces/xerces/doc/html/apiDocs/classDOMXPathEvaluator.html @ 358

Revision 358, 28.2 KB checked in by bittner, 19 years ago (diff)

xerces added
Line 
1<HTML><HEAD><SCRIPT language="JavaScript" src="../resources/script.js" type="text/javascript"></SCRIPT><TITLE>DOMXPathEvaluator class Reference</TITLE><link href="XercesApi.css" rel="stylesheet" type="text/css"></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="../resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="../resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="../resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="../graphics/api-header.jpg" vspace="0" width="456"></TD></TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="../resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','../resources/button-xml-hi.gif','../resources/button-xml-lo.gif');" src="../resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','../resources/button-asf-hi.gif','../resources/button-asf-lo.gif');" src="../resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','../resources/button-w3c-hi.gif','../resources/button-w3c-lo.gif');" src="../resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="../resources/join.gif" vspace="0" width="120"><BR>
2  <A href="../../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','../graphics/ext-2-label-2.jpg','../graphics/ext-2-label-3.jpg');" src="../graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
3
4  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
5
6  <A href="../index.html" onMouseOut="rolloverOff('side-index');" onMouseOver="rolloverOn('side-index');"><IMG alt="Readme" border="0" height="12" hspace="0" name="side-index" onLoad="rolloverLoad('side-index','../graphics/index-label-2.jpg','../graphics/index-label-3.jpg');" src="../graphics/index-label-3.jpg" vspace="0" width="120"></A><BR>
7  <A href="../releases.html" onMouseOut="rolloverOff('side-releases');" onMouseOver="rolloverOn('side-releases');"><IMG alt="Release Info" border="0" height="12" hspace="0" name="side-releases" onLoad="rolloverLoad('side-releases','../graphics/releases-label-2.jpg','../graphics/releases-label-3.jpg');" src="../graphics/releases-label-3.jpg" vspace="0" width="120"></A><BR>
8  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
9  <A href="../install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','../graphics/install-label-2.jpg','../graphics/install-label-3.jpg');" src="../graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
10  <A href="http://xml.apache.org/dist/xerces-c/" onMouseOut="rolloverOff('side-ext-18');" onMouseOver="rolloverOn('side-ext-18');"><IMG alt="Download" border="0" height="12" hspace="0" name="side-ext-18" onLoad="rolloverLoad('side-ext-18','../graphics/ext-18-label-2.jpg','../graphics/ext-18-label-3.jpg');" src="../graphics/ext-18-label-3.jpg" vspace="0" width="120"></A><BR>
11  <A href="../build.html" onMouseOut="rolloverOff('side-build');" onMouseOver="rolloverOn('side-build');"><IMG alt="Build" border="0" height="12" hspace="0" name="side-build" onLoad="rolloverLoad('side-build','../graphics/build-label-2.jpg','../graphics/build-label-3.jpg');" src="../graphics/build-label-3.jpg" vspace="0" width="120"></A><BR>
12
13  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
14  <A href="../faqs.html" onMouseOut="rolloverOff('side-faqs');" onMouseOver="rolloverOn('side-faqs');"><IMG alt="FAQs" border="0" height="12" hspace="0" name="side-faqs" onLoad="rolloverLoad('side-faqs','../graphics/faqs-label-2.jpg','../graphics/faqs-label-3.jpg');" src="../graphics/faqs-label-3.jpg" vspace="0" width="120"></A><BR> 
15  <A href="../samples.html" onMouseOut="rolloverOff('side-samples');" onMouseOver="rolloverOn('side-samples');"><IMG alt="Samples" border="0" height="12" hspace="0" name="side-samples" onLoad="rolloverLoad('side-samples','../graphics/samples-label-2.jpg','../graphics/samples-label-3.jpg');" src="../graphics/samples-label-3.jpg" vspace="0" width="120"></A><BR>
16  <A href="../api.html" onMouseOut="rolloverOff('side-api');" onMouseOver="rolloverOn('side-api');"><IMG alt="API Docs" border="0" height="12" hspace="0" name="side-api" onLoad="rolloverLoad('side-api','../graphics/api-label-2.jpg','../graphics/api-label-3.jpg');" src="../graphics/api-label-3.jpg" vspace="0" width="120"></A><BR> 
17
18  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR> 
19  <A href="../ApacheDOMC++Binding.html" onMouseOut="rolloverOff('side-ext-68');" onMouseOver="rolloverOn('side-ext-68');"><IMG alt="DOM C++ Binding" border="0" height="12" hspace="0" name="side-ext-68" onLoad="rolloverLoad('side-ext-68','../graphics/ext-68-label-2.jpg','../graphics/ext-68-label-3.jpg');" src="../graphics/ext-68-label-3.jpg" vspace="0" width="120"></A><BR>
20
21  <A href="../program.html" onMouseOut="rolloverOff('side-program');" onMouseOver="rolloverOn('side-program');"><IMG alt="Programming" border="0" height="12" hspace="0" name="side-program" onLoad="rolloverLoad('side-program','../graphics/program-label-2.jpg','../graphics/program-label-3.jpg');" src="../graphics/program-label-3.jpg" vspace="0" width="120"></A><BR>
22  <A href="../migrate.html" onMouseOut="rolloverOff('side-migrate');" onMouseOver="rolloverOn('side-migrate');"><IMG alt="Migration Guide" border="0" height="12" hspace="0" name="side-migrate" onLoad="rolloverLoad('side-migrate','../graphics/migrate-label-2.jpg','../graphics/migrate-label-3.jpg');" src="../graphics/migrate-label-3.jpg" vspace="0" width="120"></A><BR>
23
24  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
25
26  <A href="../feedback.html" onMouseOut="rolloverOff('side-feedback');" onMouseOver="rolloverOn('side-feedback');"><IMG alt="Feedback" border="0" height="12" hspace="0" name="side-feedback" onLoad="rolloverLoad('side-feedback','../graphics/feedback-label-2.jpg','../graphics/feedback-label-3.jpg');" src="../graphics/feedback-label-3.jpg" vspace="0" width="120"></A><BR>
27  <A href="../bug-report.html" onMouseOut="rolloverOff('side-bug-report');" onMouseOver="rolloverOn('side-bug-report');"><IMG alt="Bug-Reporting" border="0" height="12" hspace="0" name="side-bug-report" onLoad="rolloverLoad('side-bug-report','../graphics/bug-report-label-2.jpg','../graphics/bug-report-label-3.jpg');" src="../graphics/bug-report-label-3.jpg" vspace="0" width="120"></A><BR> 
28  <A href="../pdf.html" onMouseOut="rolloverOff('side-pdf');" onMouseOver="rolloverOn('side-pdf');"><IMG alt="PDF Document" border="0" height="12" hspace="0" name="side-pdf" onLoad="rolloverLoad('side-pdf','../graphics/pdf-label-2.jpg','../graphics/pdf-label-3.jpg');" src="../graphics/pdf-label-3.jpg" vspace="0" width="120"></A><BR>
29
30  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
31
32  <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xerces/c/" onMouseOut="rolloverOff('side-ext-100');" onMouseOver="rolloverOn('side-ext-100');"><IMG alt="CVS Repository" border="0" height="12" hspace="0" name="side-ext-100" onLoad="rolloverLoad('side-ext-100','../graphics/ext-100-label-2.jpg','../graphics/ext-100-label-3.jpg');" src="../graphics/ext-100-label-3.jpg" vspace="0" width="120"></A><BR>
33
34  <A href="http://marc.theaimsgroup.com/?l=xerces-c-dev" onMouseOut="rolloverOff('side-ext-102');" onMouseOver="rolloverOn('side-ext-102');"><IMG alt="Mail Archive" border="0" height="12" hspace="0" name="side-ext-102" onLoad="rolloverLoad('side-ext-102','../graphics/ext-102-label-2.jpg','../graphics/ext-102-label-3.jpg');" src="../graphics/ext-102-label-3.jpg" vspace="0" width="120"></A><BR>
35
36
37<IMG border="0" height="14" hspace="0" src="../resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
38    <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#FFFFFF" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="../resources/void.gif" vspace="0" width="2"><B>API Docs for SAX and DOM</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="../resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10">&nbsp;</TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
39
40            <P>
41<!-- Generated by Doxygen 1.2.14 -->
42<center>
43<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; </center>
44<hr><h1>DOMXPathEvaluator  Class Reference</h1>The evaluation of XPath expressions is provided by <code>DOMXPathEvaluator</code>.
45<a href="#_details">More...</a>
46<p>
47Inheritance diagram for DOMXPathEvaluator:<p><center><img src="classDOMXPathEvaluator__inherit__graph.gif" border="0" usemap="#DOMXPathEvaluator__inherit__map" alt="Inheritance graph"></center>
48<map name="DOMXPathEvaluator__inherit__map">
49<area href="classDOMDocument.html" shape="rect" coords="23,105,127,87" alt="">
50</map>
51<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classDOMXPathEvaluator-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
52<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
53<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
54<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classDOMXPathEvaluator.html#z184_0">~DOMXPathEvaluator</a> ()</td></tr>
55<tr><td>&nbsp;</td><td><font size=-1><em>Destructor.</em> <a href="#z184_0">More...</a><em></em></font><br><br></td></tr>
56<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 3</div></td></tr>
57<tr><td nowrap align=right valign=top>virtual const <a class="el" href="classDOMXPathExpression.html">DOMXPathExpression</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMXPathEvaluator.html#z185_0">createExpression</a> (const XMLCh *expression, const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a> *resolver)=0</td></tr>
58<tr><td>&nbsp;</td><td><font size=-1><em>Creates a parsed XPath expression with resolved namespaces.</em> <a href="#z185_0">More...</a><em></em></font><br><br></td></tr>
59<tr><td nowrap align=right valign=top>virtual const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMXPathEvaluator.html#z185_1">createNSResolver</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *nodeResolver)=0</td></tr>
60<tr><td>&nbsp;</td><td><font size=-1><em>Adapts any DOM node to resolve namespaces so that an XPath expression can be easily evaluated relative to the context of the node where it appeared within the document.</em> <a href="#z185_1">More...</a><em></em></font><br><br></td></tr>
61<tr><td nowrap align=right valign=top>virtual void *&nbsp;</td><td valign=bottom><a class="el" href="classDOMXPathEvaluator.html#z185_2">evaluate</a> (const XMLCh *expression, <a class="el" href="classDOMNode.html">DOMNode</a> *contextNode, const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a> *resolver, unsigned short type, void *result)=0</td></tr>
62<tr><td>&nbsp;</td><td><font size=-1><em>Evaluates an XPath expression string and returns a result of the specified type if possible.</em> <a href="#z185_2">More...</a><em></em></font><br><br></td></tr>
63<tr><td colspan=2><br><h2>Protected Methods</h2></td></tr>
64<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
65<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classDOMXPathEvaluator.html#z182_0">DOMXPathEvaluator</a> ()</td></tr>
66</table>
67<hr><a name="_details"></a><h2>Detailed Description</h2>
68The evaluation of XPath expressions is provided by <code>DOMXPathEvaluator</code>.
69<p>
70In a DOM implementation which supports the XPath 3.0 feature, the <code>DOMXPathEvaluator</code> interface will be implemented on the same object which implements the Document interface permitting it to be obtained by casting or by using the DOM Level 3 getInterface method. In this case the implementation obtained from the Document supports the XPath DOM module and is compatible  with the XPath 1.0 specification. Evaluation of expressions with specialized extension functions or variables may not work in all implementations and is, therefore, not portable. XPathEvaluator implementations may be available from other sources that could provide specific support for specialized extension functions or variables as would be defined by other specifications. <dl compact><dt><b>
71Since: </b><dd>
72DOM Level 3 </dl>
73<p>
74<hr><h2>Constructor &amp; Destructor Documentation</h2>
75<a name="z182_0" doxytag="DOMXPathEvaluator::DOMXPathEvaluator"></a><p>
76<table width="100%" cellpadding="2" cellspacing="0" border="0">
77  <tr>
78    <td class="md">
79      <table cellpadding="0" cellspacing="0" border="0">
80        <tr>
81          <td class="md" nowrap valign="top"> DOMXPathEvaluator::DOMXPathEvaluator </td>
82          <td class="md" valign="top">(&nbsp;</td>
83          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
84          <td class="md" valign="top">)&nbsp;</td>
85          <td class="md" nowrap><code> [protected]</code></td>
86        </tr>
87
88      </table>
89    </td>
90  </tr>
91</table>
92<table cellspacing=5 cellpadding=0 border=0>
93  <tr>
94    <td>
95      &nbsp;
96    </td>
97    <td>
98
99<p>
100    </td>
101  </tr>
102</table>
103<a name="z184_0" doxytag="DOMXPathEvaluator::~DOMXPathEvaluator"></a><p>
104<table width="100%" cellpadding="2" cellspacing="0" border="0">
105  <tr>
106    <td class="md">
107      <table cellpadding="0" cellspacing="0" border="0">
108        <tr>
109          <td class="md" nowrap valign="top"> virtual DOMXPathEvaluator::~DOMXPathEvaluator </td>
110          <td class="md" valign="top">(&nbsp;</td>
111          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
112          <td class="md" valign="top">)&nbsp;</td>
113          <td class="md" nowrap><code> [virtual]</code></td>
114        </tr>
115
116      </table>
117    </td>
118  </tr>
119</table>
120<table cellspacing=5 cellpadding=0 border=0>
121  <tr>
122    <td>
123      &nbsp;
124    </td>
125    <td>
126
127<p>
128Destructor.
129<p>
130    </td>
131  </tr>
132</table>
133<hr><h2>Member Function Documentation</h2>
134<a name="z185_0" doxytag="DOMXPathEvaluator::createExpression"></a><p>
135<table width="100%" cellpadding="2" cellspacing="0" border="0">
136  <tr>
137    <td class="md">
138      <table cellpadding="0" cellspacing="0" border="0">
139        <tr>
140          <td class="md" nowrap valign="top"> virtual const <a class="el" href="classDOMXPathExpression.html">DOMXPathExpression</a>* DOMXPathEvaluator::createExpression </td>
141          <td class="md" valign="top">(&nbsp;</td>
142          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
143          <td class="mdname" nowrap>&nbsp; <em>expression</em>, </td>
144        </tr>
145        <tr>
146          <td></td>
147          <td></td>
148          <td class="md" nowrap>const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a> *&nbsp;</td>
149          <td class="mdname" nowrap>&nbsp; <em>resolver</em></td>
150        </tr>
151        <tr>
152          <td></td>
153          <td class="md">)&nbsp;</td>
154          <td class="md" colspan="2"><code> [pure virtual]</code></td>
155        </tr>
156
157      </table>
158    </td>
159  </tr>
160</table>
161<table cellspacing=5 cellpadding=0 border=0>
162  <tr>
163    <td>
164      &nbsp;
165    </td>
166    <td>
167
168<p>
169Creates a parsed XPath expression with resolved namespaces.
170<p>
171This is useful when an expression will be reused in an application since it makes it  possible to compile the expression string into a more efficient internal  form and preresolve all namespace prefixes which occur within the expression. <dl compact><dt><b>
172Parameters: </b><dd>
173<table border=0 cellspacing=2 cellpadding=0>
174<tr><td valign=top><em>expression</em>&nbsp;</td><td>
175of type XMLCh - The XPath expression string to be parsed. </td></tr>
176<tr><td valign=top><em>resolver</em>&nbsp;</td><td>
177of type <code>XPathNSResolver</code> - The resolver permits  translation of all prefixes, including the xml namespace prefix, within the XPath expression into appropriate namespace URIs. If this is specified as null, any namespace  prefix within the expression will result in <code><a class="el" href="classDOMException.html">DOMException</a></code> being thrown with the code NAMESPACE_ERR. </td></tr>
178</table>
179</dl><dl compact><dt><b>
180Returns: </b><dd>
181<code>XPathExpression</code> The compiled form of the XPath expression. </dl><dl compact><dt><b>
182Exceptions: </b><dd>
183<table border=0 cellspacing=2 cellpadding=0>
184<tr><td valign=top><em>code</em>&nbsp;</td><td>
185&gt;XPathException</code> INVALID_EXPRESSION_ERR: Raised if the expression is not legal according to the  rules of the <code>DOMXPathEvaluator</code>. </td></tr>
186<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
187 NAMESPACE_ERR: Raised if the expression contains namespace prefixes which cannot be resolved by the specified <code>XPathNSResolver</code>. </td></tr>
188</table>
189</dl><dl compact><dt><b>
190Since: </b><dd>
191DOM Level 3 </dl>    </td>
192  </tr>
193</table>
194<a name="z185_1" doxytag="DOMXPathEvaluator::createNSResolver"></a><p>
195<table width="100%" cellpadding="2" cellspacing="0" border="0">
196  <tr>
197    <td class="md">
198      <table cellpadding="0" cellspacing="0" border="0">
199        <tr>
200          <td class="md" nowrap valign="top"> virtual const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a>* DOMXPathEvaluator::createNSResolver </td>
201          <td class="md" valign="top">(&nbsp;</td>
202          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
203          <td class="mdname1" valign="top" nowrap>&nbsp; <em>nodeResolver</em>          </td>
204          <td class="md" valign="top">)&nbsp;</td>
205          <td class="md" nowrap><code> [pure virtual]</code></td>
206        </tr>
207
208      </table>
209    </td>
210  </tr>
211</table>
212<table cellspacing=5 cellpadding=0 border=0>
213  <tr>
214    <td>
215      &nbsp;
216    </td>
217    <td>
218
219<p>
220Adapts any DOM node to resolve namespaces so that an XPath expression can be easily evaluated relative to the context of the node where it appeared within the document.
221<p>
222This adapter works like the DOM Level 3 method lookupNamespaceURI on nodes in resolving the namespaceURI from a given prefix using the current  information available in the node's hierarchy at the time lookupNamespaceURI  is called. also correctly resolving the implicit xml prefix. <dl compact><dt><b>
223Parameters: </b><dd>
224<table border=0 cellspacing=2 cellpadding=0>
225<tr><td valign=top><em>nodeResolver</em>&nbsp;</td><td>
226of type <code><a class="el" href="classDOMNode.html">DOMNode</a></code> The node to be used as a context  for namespace resolution. </td></tr>
227</table>
228</dl><dl compact><dt><b>
229Returns: </b><dd>
230<code>XPathNSResolver</code> <code>XPathNSResolver</code> which resolves namespaces  with respect to the definitions in scope for a specified node. </dl>    </td>
231  </tr>
232</table>
233<a name="z185_2" doxytag="DOMXPathEvaluator::evaluate"></a><p>
234<table width="100%" cellpadding="2" cellspacing="0" border="0">
235  <tr>
236    <td class="md">
237      <table cellpadding="0" cellspacing="0" border="0">
238        <tr>
239          <td class="md" nowrap valign="top"> virtual void* DOMXPathEvaluator::evaluate </td>
240          <td class="md" valign="top">(&nbsp;</td>
241          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
242          <td class="mdname" nowrap>&nbsp; <em>expression</em>, </td>
243        </tr>
244        <tr>
245          <td></td>
246          <td></td>
247          <td class="md" nowrap><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
248          <td class="mdname" nowrap>&nbsp; <em>contextNode</em>, </td>
249        </tr>
250        <tr>
251          <td></td>
252          <td></td>
253          <td class="md" nowrap>const <a class="el" href="classDOMXPathNSResolver.html">DOMXPathNSResolver</a> *&nbsp;</td>
254          <td class="mdname" nowrap>&nbsp; <em>resolver</em>, </td>
255        </tr>
256        <tr>
257          <td></td>
258          <td></td>
259          <td class="md" nowrap>unsigned short&nbsp;</td>
260          <td class="mdname" nowrap>&nbsp; <em>type</em>, </td>
261        </tr>
262        <tr>
263          <td></td>
264          <td></td>
265          <td class="md" nowrap>void *&nbsp;</td>
266          <td class="mdname" nowrap>&nbsp; <em>result</em></td>
267        </tr>
268        <tr>
269          <td></td>
270          <td class="md">)&nbsp;</td>
271          <td class="md" colspan="2"><code> [pure virtual]</code></td>
272        </tr>
273
274      </table>
275    </td>
276  </tr>
277</table>
278<table cellspacing=5 cellpadding=0 border=0>
279  <tr>
280    <td>
281      &nbsp;
282    </td>
283    <td>
284
285<p>
286Evaluates an XPath expression string and returns a result of the specified type if possible.
287<p>
288<dl compact><dt><b>
289Parameters: </b><dd>
290<table border=0 cellspacing=2 cellpadding=0>
291<tr><td valign=top><em>expression</em>&nbsp;</td><td>
292of type XMLCh The XPath expression string to be parsed  and evaluated. </td></tr>
293<tr><td valign=top><em>contextNode</em>&nbsp;</td><td>
294of type <code><a class="el" href="classDOMNode.html">DOMNode</a></code> The context is context node  for the evaluation  of this XPath expression. If the <code>DOMXPathEvaluator</code> was obtained by casting the <code><a class="el" href="classDOMDocument.html">DOMDocument</a></code> then this must be owned by the same  document and must be a <code><a class="el" href="classDOMDocument.html">DOMDocument</a></code>, <code><a class="el" href="classDOMElement.html">DOMElement</a></code>,  <code>DOMAttribute</code>, <code><a class="el" href="classDOMText.html">DOMText</a></code>, <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code>,  <code><a class="el" href="classDOMComment.html">DOMComment</a></code>, <code><a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a></code>, or  <code>XPathNamespace</code> node. If the context node is a <code><a class="el" href="classDOMText.html">DOMText</a></code> or  a <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code>, then the context is interpreted as the whole  logical text node as seen by XPath, unless the node is empty in which case it may not serve as the XPath context. </td></tr>
295<tr><td valign=top><em>resolver</em>&nbsp;</td><td>
296of type <code>XPathNSResolver</code> The resolver permits  translation of all prefixes, including the xml namespace prefix, within  the XPath expression into appropriate namespace URIs. If this is specified  as null, any namespace prefix within the expression will result in  <code><a class="el" href="classDOMException.html">DOMException</a></code> being thrown with the code NAMESPACE_ERR. </td></tr>
297<tr><td valign=top><em>type</em>&nbsp;</td><td>
298of type unsigned short - If a specific type is specified, then  the result will be returned as the corresponding type. For XPath 1.0 results, this must be one of the codes of the <code>XPathResult</code> interface. </td></tr>
299<tr><td valign=top><em>result</em>&nbsp;</td><td>
300of type void* - The result specifies a specific result object which may be reused and returned by this method. If this is specified as  null or the implementation does not reuse the specified result, a new result object will be constructed and returned. For XPath 1.0 results, this object will be of type <code>XPathResult</code>. </td></tr>
301</table>
302</dl><dl compact><dt><b>
303Returns: </b><dd>
304void* The result of the evaluation of the XPath expression. For XPath 1.0 results, this object will be of type <code>XPathResult</code>. </dl><dl compact><dt><b>
305Exceptions: </b><dd>
306<table border=0 cellspacing=2 cellpadding=0>
307<tr><td valign=top><em>code</em>&nbsp;</td><td>
308&gt;XPathException</code> INVALID_EXPRESSION_ERR: Raised if the expression is not legal  according to the rules of the <code>DOMXPathEvaluator</code> TYPE_ERR: Raised if the result cannot be converted to return the specified type. </td></tr>
309<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
310 NAMESPACE_ERR: Raised if the expression contains namespace prefixes  which cannot be resolved by the specified <code>XPathNSResolver</code>. WRONG_DOCUMENT_ERR: The Node is from a document that is not supported  by this <code>DOMXPathEvaluator</code>. NOT_SUPPORTED_ERR: The Node is not a type permitted as an XPath context  node or the request type is not permitted by this <code>DOMXPathEvaluator</code>. </td></tr>
311</table>
312</dl>    </td>
313  </tr>
314</table>
315<hr>The documentation for this class was generated from the following file:<ul>
316<li><a class="el" href="DOMXPathEvaluator_8hpp-source.html">DOMXPathEvaluator.hpp</a></ul>
317    </FONT></TD></TR></TABLE><BR>
318</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1" alt=""></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
319              Copyright &copy; 1994-2004 The Apache Software Foundation.
320              All Rights Reserved.
321            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.