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

Revision 358, 107.6 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>SAX2XMLReader 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>SAX2XMLReader  Class Reference</h1><a href="classSAX2XMLReader-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
45<tr><td colspan=2><br><h2>Public Types</h2></td></tr>
46<tr><td colspan="2"><div class="groupHeader">Public constants</div></td></tr>
47<tr><td nowrap align=right valign=top>enum &nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z543_0">ValSchemes</a> { <a class="el" href="classSAX2XMLReader.html#z543_0s0">Val_Never</a>,
48<a class="el" href="classSAX2XMLReader.html#z543_0s1">Val_Always</a>,
49<a class="el" href="classSAX2XMLReader.html#z543_0s2">Val_Auto</a>
50 }</td></tr>
51<tr><td>&nbsp;</td><td><font size=-1><em>ValScheme enum used in setValidationScheme Val_Never: Do not report validation errors.</em> <a href="#z543_0">More...</a><em></em></font><br><br></td></tr>
52<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
53<tr><td colspan="2"><div class="groupHeader">Constructors and Destructor</div></td></tr>
54<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z544_0">SAX2XMLReader</a> ()</td></tr>
55<tr><td>&nbsp;</td><td><font size=-1><em>The default constructor.</em> <a href="#z544_0">More...</a><em></em></font><br><br></td></tr>
56<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z544_1">~SAX2XMLReader</a> ()</td></tr>
57<tr><td>&nbsp;</td><td><font size=-1><em>The destructor.</em> <a href="#z544_1">More...</a><em></em></font><br><br></td></tr>
58<tr><td colspan="2"><div class="groupHeader">Implementation of SAX 2.0 XMLReader interface's.</div></td></tr>
59<tr><td nowrap align=right valign=top>virtual <a class="el" href="classContentHandler.html">ContentHandler</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_0">getContentHandler</a> () const=0</td></tr>
60<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed content handler.</em> <a href="#z545_0">More...</a><em></em></font><br><br></td></tr>
61<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDTDHandler.html">DTDHandler</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_1">getDTDHandler</a> () const=0</td></tr>
62<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed DTD handler.</em> <a href="#z545_1">More...</a><em></em></font><br><br></td></tr>
63<tr><td nowrap align=right valign=top>virtual <a class="el" href="classEntityResolver.html">EntityResolver</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_2">getEntityResolver</a> () const=0</td></tr>
64<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed entity resolver.</em> <a href="#z545_2">More...</a><em></em></font><br><br></td></tr>
65<tr><td nowrap align=right valign=top>virtual <a class="el" href="classErrorHandler.html">ErrorHandler</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_3">getErrorHandler</a> () const=0</td></tr>
66<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed error handler.</em> <a href="#z545_3">More...</a><em></em></font><br><br></td></tr>
67<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_4">getFeature</a> (const XMLCh *const name) const=0</td></tr>
68<tr><td>&nbsp;</td><td><font size=-1><em>Query the current state of any feature in a SAX2 XMLReader.</em> <a href="#z545_4">More...</a><em></em></font><br><br></td></tr>
69<tr><td nowrap align=right valign=top>virtual void *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_5">getProperty</a> (const XMLCh *const name) const=0</td></tr>
70<tr><td>&nbsp;</td><td><font size=-1><em>Query the current value of a property in a SAX2 XMLReader.</em> <a href="#z545_5">More...</a><em></em></font><br><br></td></tr>
71<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_6">setContentHandler</a> (<a class="el" href="classContentHandler.html">ContentHandler</a> *const handler)=0</td></tr>
72<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register a document event handler.</em> <a href="#z545_6">More...</a><em></em></font><br><br></td></tr>
73<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_7">setDTDHandler</a> (<a class="el" href="classDTDHandler.html">DTDHandler</a> *const handler)=0</td></tr>
74<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register a DTD event handler.</em> <a href="#z545_7">More...</a><em></em></font><br><br></td></tr>
75<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_8">setEntityResolver</a> (<a class="el" href="classEntityResolver.html">EntityResolver</a> *const resolver)=0</td></tr>
76<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register a custom entity resolver.</em> <a href="#z545_8">More...</a><em></em></font><br><br></td></tr>
77<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_9">setErrorHandler</a> (<a class="el" href="classErrorHandler.html">ErrorHandler</a> *const handler)=0</td></tr>
78<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register an error event handler.</em> <a href="#z545_9">More...</a><em></em></font><br><br></td></tr>
79<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_10">setFeature</a> (const XMLCh *const name, const bool value)=0</td></tr>
80<tr><td>&nbsp;</td><td><font size=-1><em>Set the state of any feature in a SAX2 XMLReader.</em> <a href="#z545_10">More...</a><em></em></font><br><br></td></tr>
81<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_11">setProperty</a> (const XMLCh *const name, void *value)=0</td></tr>
82<tr><td>&nbsp;</td><td><font size=-1><em>Set the value of any property in a SAX2 XMLReader.</em> <a href="#z545_11">More...</a><em></em></font><br><br></td></tr>
83<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_12">parse</a> (const <a class="el" href="classInputSource.html">InputSource</a> &amp;source)=0</td></tr>
84<tr><td>&nbsp;</td><td><font size=-1><em>Parse an XML document.</em> <a href="#z545_12">More...</a><em></em></font><br><br></td></tr>
85<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_13">parse</a> (const XMLCh *const systemId)=0</td></tr>
86<tr><td>&nbsp;</td><td><font size=-1><em>Parse an XML document from a system identifier (URI).</em> <a href="#z545_13">More...</a><em></em></font><br><br></td></tr>
87<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z545_14">parse</a> (const char *const systemId)=0</td></tr>
88<tr><td>&nbsp;</td><td><font size=-1><em>Parse an XML document from a system identifier (URI).</em> <a href="#z545_14">More...</a><em></em></font><br><br></td></tr>
89<tr><td colspan="2"><div class="groupHeader">SAX 2.0-ext</div></td></tr>
90<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDeclHandler.html">DeclHandler</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z546_0">getDeclarationHandler</a> () const=0</td></tr>
91<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed declaration handler.</em> <a href="#z546_0">More...</a><em></em></font><br><br></td></tr>
92<tr><td nowrap align=right valign=top>virtual <a class="el" href="classLexicalHandler.html">LexicalHandler</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z546_1">getLexicalHandler</a> () const=0</td></tr>
93<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the installed lexical handler.</em> <a href="#z546_1">More...</a><em></em></font><br><br></td></tr>
94<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z546_2">setDeclarationHandler</a> (<a class="el" href="classDeclHandler.html">DeclHandler</a> *const handler)=0</td></tr>
95<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register a declaration event handler.</em> <a href="#z546_2">More...</a><em></em></font><br><br></td></tr>
96<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z546_3">setLexicalHandler</a> (<a class="el" href="classLexicalHandler.html">LexicalHandler</a> *const handler)=0</td></tr>
97<tr><td>&nbsp;</td><td><font size=-1><em>Allow an application to register a lexical event handler.</em> <a href="#z546_3">More...</a><em></em></font><br><br></td></tr>
98<tr><td colspan="2"><div class="groupHeader">Getter Methods (Xerces-C specific)</div></td></tr>
99<tr><td nowrap align=right valign=top>virtual <a class="el" href="classXMLValidator.html">XMLValidator</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_0">getValidator</a> () const=0</td></tr>
100<tr><td>&nbsp;</td><td><font size=-1><em>This method is used to get the current validator.</em> <a href="#z547_0">More...</a><em></em></font><br><br></td></tr>
101<tr><td nowrap align=right valign=top>virtual int&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_1">getErrorCount</a> () const=0</td></tr>
102<tr><td>&nbsp;</td><td><font size=-1><em>Get error count from the last parse operation.</em> <a href="#z547_1">More...</a><em></em></font><br><br></td></tr>
103<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_2">getExitOnFirstFatalError</a> () const=0</td></tr>
104<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the state of the parser's exit-on-First-Fatal-Error flag.</em> <a href="#z547_2">More...</a><em></em></font><br><br></td></tr>
105<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_3">getValidationConstraintFatal</a> () const=0</td></tr>
106<tr><td>&nbsp;</td><td><font size=-1><em>This method returns the state of the parser's validation-constraint-fatal flag.</em> <a href="#z547_3">More...</a><em></em></font><br><br></td></tr>
107<tr><td nowrap align=right valign=top>virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_4">getGrammar</a> (const XMLCh *const nameSpaceKey)=0</td></tr>
108<tr><td>&nbsp;</td><td><font size=-1><em>Retrieve the grammar that is associated with the specified namespace key.</em> <a href="#z547_4">More...</a><em></em></font><br><br></td></tr>
109<tr><td nowrap align=right valign=top>virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_5">getRootGrammar</a> ()=0</td></tr>
110<tr><td>&nbsp;</td><td><font size=-1><em>Retrieve the grammar where the root element is declared.</em> <a href="#z547_5">More...</a><em></em></font><br><br></td></tr>
111<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_6">getURIText</a> (unsigned int uriId) const=0</td></tr>
112<tr><td>&nbsp;</td><td><font size=-1><em>Returns the string corresponding to a URI id from the URI string pool.</em> <a href="#z547_6">More...</a><em></em></font><br><br></td></tr>
113<tr><td nowrap align=right valign=top>virtual unsigned int&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z547_7">getSrcOffset</a> () const=0</td></tr>
114<tr><td>&nbsp;</td><td><font size=-1><em>Returns the current src offset within the input source.</em> <a href="#z547_7">More...</a><em></em></font><br><br></td></tr>
115<tr><td colspan="2"><div class="groupHeader">Setter Methods (Xerces-C specific)</div></td></tr>
116<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z548_0">setValidator</a> (<a class="el" href="classXMLValidator.html">XMLValidator</a> *valueToAdopt)=0</td></tr>
117<tr><td>&nbsp;</td><td><font size=-1><em>This method is used to set a validator.</em> <a href="#z548_0">More...</a><em></em></font><br><br></td></tr>
118<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z548_1">setExitOnFirstFatalError</a> (const bool newState)=0</td></tr>
119<tr><td>&nbsp;</td><td><font size=-1><em>This method allows users to set the parser's behaviour when it encounters the first fatal error.</em> <a href="#z548_1">More...</a><em></em></font><br><br></td></tr>
120<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z548_2">setValidationConstraintFatal</a> (const bool newState)=0</td></tr>
121<tr><td>&nbsp;</td><td><font size=-1><em>This method allows users to set the parser's behaviour when it encounters a validtion constraint error.</em> <a href="#z548_2">More...</a><em></em></font><br><br></td></tr>
122<tr><td colspan="2"><div class="groupHeader">Progressive scan methods</div></td></tr>
123<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a> (const XMLCh *const systemId, <a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;toFill)=0</td></tr>
124<tr><td>&nbsp;</td><td><font size=-1><em>Begin a progressive parse operation.</em> <a href="#z549_0">More...</a><em></em></font><br><br></td></tr>
125<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z549_1">parseFirst</a> (const char *const systemId, <a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;toFill)=0</td></tr>
126<tr><td>&nbsp;</td><td><font size=-1><em>Begin a progressive parse operation.</em> <a href="#z549_1">More...</a><em></em></font><br><br></td></tr>
127<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z549_2">parseFirst</a> (const <a class="el" href="classInputSource.html">InputSource</a> &amp;source, <a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;toFill)=0</td></tr>
128<tr><td>&nbsp;</td><td><font size=-1><em>Begin a progressive parse operation.</em> <a href="#z549_2">More...</a><em></em></font><br><br></td></tr>
129<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z549_3">parseNext</a> (<a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;token)=0</td></tr>
130<tr><td>&nbsp;</td><td><font size=-1><em>Continue a progressive parse operation.</em> <a href="#z549_3">More...</a><em></em></font><br><br></td></tr>
131<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z549_4">parseReset</a> (<a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;token)=0</td></tr>
132<tr><td>&nbsp;</td><td><font size=-1><em>Reset the parser after a progressive parse.</em> <a href="#z549_4">More...</a><em></em></font><br><br></td></tr>
133<tr><td colspan="2"><div class="groupHeader">Grammar preparsing interface's.</div></td></tr>
134<tr><td nowrap align=right valign=top>virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z550_0">loadGrammar</a> (const <a class="el" href="classInputSource.html">InputSource</a> &amp;source, const short grammarType, const bool toCache=false)=0</td></tr>
135<tr><td>&nbsp;</td><td><font size=-1><em>Preparse schema grammar (XML Schema, DTD, etc.) via an input source object.</em> <a href="#z550_0">More...</a><em></em></font><br><br></td></tr>
136<tr><td nowrap align=right valign=top>virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z550_1">loadGrammar</a> (const XMLCh *const systemId, const short grammarType, const bool toCache=false)=0</td></tr>
137<tr><td>&nbsp;</td><td><font size=-1><em>Preparse schema grammar (XML Schema, DTD, etc.) via a file path or URL.</em> <a href="#z550_1">More...</a><em></em></font><br><br></td></tr>
138<tr><td nowrap align=right valign=top>virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a> *&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z550_2">loadGrammar</a> (const char *const systemId, const short grammarType, const bool toCache=false)=0</td></tr>
139<tr><td>&nbsp;</td><td><font size=-1><em>Preparse schema grammar (XML Schema, DTD, etc.) via a file path or URL.</em> <a href="#z550_2">More...</a><em></em></font><br><br></td></tr>
140<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z550_3">resetCachedGrammarPool</a> ()=0</td></tr>
141<tr><td>&nbsp;</td><td><font size=-1><em>Clear the cached grammar pool.</em> <a href="#z550_3">More...</a><em></em></font><br><br></td></tr>
142<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z550_4">setInputBufferSize</a> (const size_t bufferSize)</td></tr>
143<tr><td>&nbsp;</td><td><font size=-1><em>Set maximum input buffer size.</em> <a href="#z550_4">More...</a><em></em></font><br><br></td></tr>
144<tr><td colspan="2"><div class="groupHeader">Advanced document handler list maintenance methods</div></td></tr>
145<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z551_0">installAdvDocHandler</a> (<a class="el" href="classXMLDocumentHandler.html">XMLDocumentHandler</a> *const toInstall)=0</td></tr>
146<tr><td>&nbsp;</td><td><font size=-1><em>This method installs the specified 'advanced' document callback handler, thereby allowing the user to customize the processing, if they choose to do so.</em> <a href="#z551_0">More...</a><em></em></font><br><br></td></tr>
147<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classSAX2XMLReader.html#z551_1">removeAdvDocHandler</a> (<a class="el" href="classXMLDocumentHandler.html">XMLDocumentHandler</a> *const toRemove)=0</td></tr>
148<tr><td>&nbsp;</td><td><font size=-1><em>This method removes the 'advanced' document handler callback from the underlying parser scanner.</em> <a href="#z551_1">More...</a><em></em></font><br><br></td></tr>
149</table>
150<hr><h2>Member Enumeration Documentation</h2>
151<a name="z543_0" doxytag="SAX2XMLReader::ValSchemes"></a><p>
152<table width="100%" cellpadding="2" cellspacing="0" border="0">
153  <tr>
154    <td class="md">
155      <table cellpadding="0" cellspacing="0" border="0">
156        <tr>
157          <td class="md" nowrap valign="top"> enum SAX2XMLReader::ValSchemes
158      </table>
159    </td>
160  </tr>
161</table>
162<table cellspacing=5 cellpadding=0 border=0>
163  <tr>
164    <td>
165      &nbsp;
166    </td>
167    <td>
168
169<p>
170ValScheme enum used in setValidationScheme Val_Never: Do not report validation errors.
171<p>
172Val_Always: The parser will always report validation errors. Val_Auto: The parser will report validation errors only if a grammar is specified.
173<p>
174<dl compact><dt><b>
175See also: </b><dd>
176setValidationScheme </dl><dl compact><dt><b>
177Enumeration values:</b><dd>
178<table border=0 cellspacing=2 cellpadding=0>
179<tr><td valign=top><em><a name="z543_0s0" doxytag="Val_Never"></a><em>Val_Never</em></em>&nbsp;</td><td>
180</td></tr>
181<tr><td valign=top><em><a name="z543_0s1" doxytag="Val_Always"></a><em>Val_Always</em></em>&nbsp;</td><td>
182</td></tr>
183<tr><td valign=top><em><a name="z543_0s2" doxytag="Val_Auto"></a><em>Val_Auto</em></em>&nbsp;</td><td>
184</td></tr>
185</table>
186</dl>
187    </td>
188  </tr>
189</table>
190<hr><h2>Constructor &amp; Destructor Documentation</h2>
191<a name="z544_0" doxytag="SAX2XMLReader::SAX2XMLReader"></a><p>
192<table width="100%" cellpadding="2" cellspacing="0" border="0">
193  <tr>
194    <td class="md">
195      <table cellpadding="0" cellspacing="0" border="0">
196        <tr>
197          <td class="md" nowrap valign="top"> SAX2XMLReader::SAX2XMLReader </td>
198          <td class="md" valign="top">(&nbsp;</td>
199          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
200          <td class="md" valign="top">)&nbsp;</td>
201          <td class="md" nowrap></td>
202        </tr>
203
204      </table>
205    </td>
206  </tr>
207</table>
208<table cellspacing=5 cellpadding=0 border=0>
209  <tr>
210    <td>
211      &nbsp;
212    </td>
213    <td>
214
215<p>
216The default constructor.
217<p>
218    </td>
219  </tr>
220</table>
221<a name="z544_1" doxytag="SAX2XMLReader::~SAX2XMLReader"></a><p>
222<table width="100%" cellpadding="2" cellspacing="0" border="0">
223  <tr>
224    <td class="md">
225      <table cellpadding="0" cellspacing="0" border="0">
226        <tr>
227          <td class="md" nowrap valign="top"> virtual SAX2XMLReader::~SAX2XMLReader </td>
228          <td class="md" valign="top">(&nbsp;</td>
229          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
230          <td class="md" valign="top">)&nbsp;</td>
231          <td class="md" nowrap><code> [virtual]</code></td>
232        </tr>
233
234      </table>
235    </td>
236  </tr>
237</table>
238<table cellspacing=5 cellpadding=0 border=0>
239  <tr>
240    <td>
241      &nbsp;
242    </td>
243    <td>
244
245<p>
246The destructor.
247<p>
248    </td>
249  </tr>
250</table>
251<hr><h2>Member Function Documentation</h2>
252<a name="z545_0" doxytag="SAX2XMLReader::getContentHandler"></a><p>
253<table width="100%" cellpadding="2" cellspacing="0" border="0">
254  <tr>
255    <td class="md">
256      <table cellpadding="0" cellspacing="0" border="0">
257        <tr>
258          <td class="md" nowrap valign="top"> virtual <a class="el" href="classContentHandler.html">ContentHandler</a>* SAX2XMLReader::getContentHandler </td>
259          <td class="md" valign="top">(&nbsp;</td>
260          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
261          <td class="md" valign="top">)&nbsp;</td>
262          <td class="md" nowrap> const<code> [pure virtual]</code></td>
263        </tr>
264
265      </table>
266    </td>
267  </tr>
268</table>
269<table cellspacing=5 cellpadding=0 border=0>
270  <tr>
271    <td>
272      &nbsp;
273    </td>
274    <td>
275
276<p>
277This method returns the installed content handler.
278<p>
279<dl compact><dt><b>
280Returns: </b><dd>
281A pointer to the installed content handler object. </dl>    </td>
282  </tr>
283</table>
284<a name="z546_0" doxytag="SAX2XMLReader::getDeclarationHandler"></a><p>
285<table width="100%" cellpadding="2" cellspacing="0" border="0">
286  <tr>
287    <td class="md">
288      <table cellpadding="0" cellspacing="0" border="0">
289        <tr>
290          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDeclHandler.html">DeclHandler</a>* SAX2XMLReader::getDeclarationHandler </td>
291          <td class="md" valign="top">(&nbsp;</td>
292          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
293          <td class="md" valign="top">)&nbsp;</td>
294          <td class="md" nowrap> const<code> [pure virtual]</code></td>
295        </tr>
296
297      </table>
298    </td>
299  </tr>
300</table>
301<table cellspacing=5 cellpadding=0 border=0>
302  <tr>
303    <td>
304      &nbsp;
305    </td>
306    <td>
307
308<p>
309This method returns the installed declaration handler.
310<p>
311<dl compact><dt><b>
312Returns: </b><dd>
313A pointer to the installed declaration handler object. </dl>    </td>
314  </tr>
315</table>
316<a name="z545_1" doxytag="SAX2XMLReader::getDTDHandler"></a><p>
317<table width="100%" cellpadding="2" cellspacing="0" border="0">
318  <tr>
319    <td class="md">
320      <table cellpadding="0" cellspacing="0" border="0">
321        <tr>
322          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDTDHandler.html">DTDHandler</a>* SAX2XMLReader::getDTDHandler </td>
323          <td class="md" valign="top">(&nbsp;</td>
324          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
325          <td class="md" valign="top">)&nbsp;</td>
326          <td class="md" nowrap> const<code> [pure virtual]</code></td>
327        </tr>
328
329      </table>
330    </td>
331  </tr>
332</table>
333<table cellspacing=5 cellpadding=0 border=0>
334  <tr>
335    <td>
336      &nbsp;
337    </td>
338    <td>
339
340<p>
341This method returns the installed DTD handler.
342<p>
343<dl compact><dt><b>
344Returns: </b><dd>
345A pointer to the installed DTD handler object. </dl>    </td>
346  </tr>
347</table>
348<a name="z545_2" doxytag="SAX2XMLReader::getEntityResolver"></a><p>
349<table width="100%" cellpadding="2" cellspacing="0" border="0">
350  <tr>
351    <td class="md">
352      <table cellpadding="0" cellspacing="0" border="0">
353        <tr>
354          <td class="md" nowrap valign="top"> virtual <a class="el" href="classEntityResolver.html">EntityResolver</a>* SAX2XMLReader::getEntityResolver </td>
355          <td class="md" valign="top">(&nbsp;</td>
356          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
357          <td class="md" valign="top">)&nbsp;</td>
358          <td class="md" nowrap> const<code> [pure virtual]</code></td>
359        </tr>
360
361      </table>
362    </td>
363  </tr>
364</table>
365<table cellspacing=5 cellpadding=0 border=0>
366  <tr>
367    <td>
368      &nbsp;
369    </td>
370    <td>
371
372<p>
373This method returns the installed entity resolver.
374<p>
375<dl compact><dt><b>
376Returns: </b><dd>
377A pointer to the installed entity resolver object. </dl>    </td>
378  </tr>
379</table>
380<a name="z547_1" doxytag="SAX2XMLReader::getErrorCount"></a><p>
381<table width="100%" cellpadding="2" cellspacing="0" border="0">
382  <tr>
383    <td class="md">
384      <table cellpadding="0" cellspacing="0" border="0">
385        <tr>
386          <td class="md" nowrap valign="top"> virtual int SAX2XMLReader::getErrorCount </td>
387          <td class="md" valign="top">(&nbsp;</td>
388          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
389          <td class="md" valign="top">)&nbsp;</td>
390          <td class="md" nowrap> const<code> [pure virtual]</code></td>
391        </tr>
392
393      </table>
394    </td>
395  </tr>
396</table>
397<table cellspacing=5 cellpadding=0 border=0>
398  <tr>
399    <td>
400      &nbsp;
401    </td>
402    <td>
403
404<p>
405Get error count from the last parse operation.
406<p>
407This method returns the error count from the last parse operation. Note that this count is actually stored in the scanner, so this method simply returns what the scanner reports.
408<p>
409<dl compact><dt><b>
410Returns: </b><dd>
411number of errors encountered during the latest parse operation. </dl>    </td>
412  </tr>
413</table>
414<a name="z545_3" doxytag="SAX2XMLReader::getErrorHandler"></a><p>
415<table width="100%" cellpadding="2" cellspacing="0" border="0">
416  <tr>
417    <td class="md">
418      <table cellpadding="0" cellspacing="0" border="0">
419        <tr>
420          <td class="md" nowrap valign="top"> virtual <a class="el" href="classErrorHandler.html">ErrorHandler</a>* SAX2XMLReader::getErrorHandler </td>
421          <td class="md" valign="top">(&nbsp;</td>
422          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
423          <td class="md" valign="top">)&nbsp;</td>
424          <td class="md" nowrap> const<code> [pure virtual]</code></td>
425        </tr>
426
427      </table>
428    </td>
429  </tr>
430</table>
431<table cellspacing=5 cellpadding=0 border=0>
432  <tr>
433    <td>
434      &nbsp;
435    </td>
436    <td>
437
438<p>
439This method returns the installed error handler.
440<p>
441<dl compact><dt><b>
442Returns: </b><dd>
443A pointer to the installed error handler object. </dl>    </td>
444  </tr>
445</table>
446<a name="z547_2" doxytag="SAX2XMLReader::getExitOnFirstFatalError"></a><p>
447<table width="100%" cellpadding="2" cellspacing="0" border="0">
448  <tr>
449    <td class="md">
450      <table cellpadding="0" cellspacing="0" border="0">
451        <tr>
452          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::getExitOnFirstFatalError </td>
453          <td class="md" valign="top">(&nbsp;</td>
454          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
455          <td class="md" valign="top">)&nbsp;</td>
456          <td class="md" nowrap> const<code> [pure virtual]</code></td>
457        </tr>
458
459      </table>
460    </td>
461  </tr>
462</table>
463<table cellspacing=5 cellpadding=0 border=0>
464  <tr>
465    <td>
466      &nbsp;
467    </td>
468    <td>
469
470<p>
471This method returns the state of the parser's exit-on-First-Fatal-Error flag.
472<p>
473
474<p>
475Or you can query the feature "<a href="http://apache.org/xml/features/continue-after-fatal-error">http://apache.org/xml/features/continue-after-fatal-error</a>" which indicates the opposite state.
476<p>
477<dl compact><dt><b>
478Returns: </b><dd>
479true, if the parser is currently configured to exit on the first fatal error, false otherwise.</dl><dl compact><dt><b>
480See also: </b><dd>
481<a class="el" href="classSAX2XMLReader.html#z548_1">setExitOnFirstFatalError</a> , <a class="el" href="classSAX2XMLReader.html#z545_4">getFeature</a> </dl>    </td>
482  </tr>
483</table>
484<a name="z545_4" doxytag="SAX2XMLReader::getFeature"></a><p>
485<table width="100%" cellpadding="2" cellspacing="0" border="0">
486  <tr>
487    <td class="md">
488      <table cellpadding="0" cellspacing="0" border="0">
489        <tr>
490          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::getFeature </td>
491          <td class="md" valign="top">(&nbsp;</td>
492          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
493          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
494          <td class="md" valign="top">)&nbsp;</td>
495          <td class="md" nowrap> const<code> [pure virtual]</code></td>
496        </tr>
497
498      </table>
499    </td>
500  </tr>
501</table>
502<table cellspacing=5 cellpadding=0 border=0>
503  <tr>
504    <td>
505      &nbsp;
506    </td>
507    <td>
508
509<p>
510Query the current state of any feature in a SAX2 XMLReader.
511<p>
512<dl compact><dt><b>
513Parameters: </b><dd>
514<table border=0 cellspacing=2 cellpadding=0>
515<tr><td valign=top><em>name</em>&nbsp;</td><td>
516The unique identifier (URI) of the feature being set. </td></tr>
517</table>
518</dl><dl compact><dt><b>
519Returns: </b><dd>
520The current state of the feature. </dl><dl compact><dt><b>
521Exceptions: </b><dd>
522<table border=0 cellspacing=2 cellpadding=0>
523<tr><td valign=top><em><a class="el" href="classSAXNotRecognizedException.html">SAXNotRecognizedException</a></em>&nbsp;</td><td>
524 If the requested feature is not known. </td></tr>
525</table>
526</dl>    </td>
527  </tr>
528</table>
529<a name="z547_4" doxytag="SAX2XMLReader::getGrammar"></a><p>
530<table width="100%" cellpadding="2" cellspacing="0" border="0">
531  <tr>
532    <td class="md">
533      <table cellpadding="0" cellspacing="0" border="0">
534        <tr>
535          <td class="md" nowrap valign="top"> virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a>* SAX2XMLReader::getGrammar </td>
536          <td class="md" valign="top">(&nbsp;</td>
537          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
538          <td class="mdname1" valign="top" nowrap>&nbsp; <em>nameSpaceKey</em>          </td>
539          <td class="md" valign="top">)&nbsp;</td>
540          <td class="md" nowrap><code> [pure virtual]</code></td>
541        </tr>
542
543      </table>
544    </td>
545  </tr>
546</table>
547<table cellspacing=5 cellpadding=0 border=0>
548  <tr>
549    <td>
550      &nbsp;
551    </td>
552    <td>
553
554<p>
555Retrieve the grammar that is associated with the specified namespace key.
556<p>
557<dl compact><dt><b>
558Parameters: </b><dd>
559<table border=0 cellspacing=2 cellpadding=0>
560<tr><td valign=top><em>nameSpaceKey</em>&nbsp;</td><td>
561Namespace key </td></tr>
562</table>
563</dl><dl compact><dt><b>
564Returns: </b><dd>
565Grammar associated with the Namespace key. </dl>    </td>
566  </tr>
567</table>
568<a name="z546_1" doxytag="SAX2XMLReader::getLexicalHandler"></a><p>
569<table width="100%" cellpadding="2" cellspacing="0" border="0">
570  <tr>
571    <td class="md">
572      <table cellpadding="0" cellspacing="0" border="0">
573        <tr>
574          <td class="md" nowrap valign="top"> virtual <a class="el" href="classLexicalHandler.html">LexicalHandler</a>* SAX2XMLReader::getLexicalHandler </td>
575          <td class="md" valign="top">(&nbsp;</td>
576          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
577          <td class="md" valign="top">)&nbsp;</td>
578          <td class="md" nowrap> const<code> [pure virtual]</code></td>
579        </tr>
580
581      </table>
582    </td>
583  </tr>
584</table>
585<table cellspacing=5 cellpadding=0 border=0>
586  <tr>
587    <td>
588      &nbsp;
589    </td>
590    <td>
591
592<p>
593This method returns the installed lexical handler.
594<p>
595<dl compact><dt><b>
596Returns: </b><dd>
597A pointer to the installed lexical handler object. </dl>    </td>
598  </tr>
599</table>
600<a name="z545_5" doxytag="SAX2XMLReader::getProperty"></a><p>
601<table width="100%" cellpadding="2" cellspacing="0" border="0">
602  <tr>
603    <td class="md">
604      <table cellpadding="0" cellspacing="0" border="0">
605        <tr>
606          <td class="md" nowrap valign="top"> virtual void* SAX2XMLReader::getProperty </td>
607          <td class="md" valign="top">(&nbsp;</td>
608          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
609          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
610          <td class="md" valign="top">)&nbsp;</td>
611          <td class="md" nowrap> const<code> [pure virtual]</code></td>
612        </tr>
613
614      </table>
615    </td>
616  </tr>
617</table>
618<table cellspacing=5 cellpadding=0 border=0>
619  <tr>
620    <td>
621      &nbsp;
622    </td>
623    <td>
624
625<p>
626Query the current value of a property in a SAX2 XMLReader.
627<p>
628The parser owns the returned pointer. The memory allocated for the returned pointer will be destroyed when the parser is deleted.
629<p>
630To ensure assessiblity of the returned information after the parser is deleted, callers need to copy and store the returned information somewhere else; otherwise you may get unexpected result. Since the returned pointer is a generic void pointer, see <a href="http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties">http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties</a> to learn exactly what type of property value each property returns for replication.<dl compact><dt><b>
631Parameters: </b><dd>
632<table border=0 cellspacing=2 cellpadding=0>
633<tr><td valign=top><em>name</em>&nbsp;</td><td>
634The unique identifier (URI) of the property being set. </td></tr>
635</table>
636</dl><dl compact><dt><b>
637Returns: </b><dd>
638The current value of the property. The pointer spans the same life-time as the parser. A null pointer is returned if nothing was specified externally. </dl><dl compact><dt><b>
639Exceptions: </b><dd>
640<table border=0 cellspacing=2 cellpadding=0>
641<tr><td valign=top><em><a class="el" href="classSAXNotRecognizedException.html">SAXNotRecognizedException</a></em>&nbsp;</td><td>
642 If the requested property is not known. </td></tr>
643</table>
644</dl>    </td>
645  </tr>
646</table>
647<a name="z547_5" doxytag="SAX2XMLReader::getRootGrammar"></a><p>
648<table width="100%" cellpadding="2" cellspacing="0" border="0">
649  <tr>
650    <td class="md">
651      <table cellpadding="0" cellspacing="0" border="0">
652        <tr>
653          <td class="md" nowrap valign="top"> virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a>* SAX2XMLReader::getRootGrammar </td>
654          <td class="md" valign="top">(&nbsp;</td>
655          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
656          <td class="md" valign="top">)&nbsp;</td>
657          <td class="md" nowrap><code> [pure virtual]</code></td>
658        </tr>
659
660      </table>
661    </td>
662  </tr>
663</table>
664<table cellspacing=5 cellpadding=0 border=0>
665  <tr>
666    <td>
667      &nbsp;
668    </td>
669    <td>
670
671<p>
672Retrieve the grammar where the root element is declared.
673<p>
674<dl compact><dt><b>
675Returns: </b><dd>
676Grammar where root element declared </dl>    </td>
677  </tr>
678</table>
679<a name="z547_7" doxytag="SAX2XMLReader::getSrcOffset"></a><p>
680<table width="100%" cellpadding="2" cellspacing="0" border="0">
681  <tr>
682    <td class="md">
683      <table cellpadding="0" cellspacing="0" border="0">
684        <tr>
685          <td class="md" nowrap valign="top"> virtual unsigned int SAX2XMLReader::getSrcOffset </td>
686          <td class="md" valign="top">(&nbsp;</td>
687          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
688          <td class="md" valign="top">)&nbsp;</td>
689          <td class="md" nowrap> const<code> [pure virtual]</code></td>
690        </tr>
691
692      </table>
693    </td>
694  </tr>
695</table>
696<table cellspacing=5 cellpadding=0 border=0>
697  <tr>
698    <td>
699      &nbsp;
700    </td>
701    <td>
702
703<p>
704Returns the current src offset within the input source.
705<p>
706<dl compact><dt><b>
707Returns: </b><dd>
708offset within the input source </dl>    </td>
709  </tr>
710</table>
711<a name="z547_6" doxytag="SAX2XMLReader::getURIText"></a><p>
712<table width="100%" cellpadding="2" cellspacing="0" border="0">
713  <tr>
714    <td class="md">
715      <table cellpadding="0" cellspacing="0" border="0">
716        <tr>
717          <td class="md" nowrap valign="top"> virtual const XMLCh* SAX2XMLReader::getURIText </td>
718          <td class="md" valign="top">(&nbsp;</td>
719          <td class="md" nowrap valign="top">unsigned int&nbsp;</td>
720          <td class="mdname1" valign="top" nowrap>&nbsp; <em>uriId</em>          </td>
721          <td class="md" valign="top">)&nbsp;</td>
722          <td class="md" nowrap> const<code> [pure virtual]</code></td>
723        </tr>
724
725      </table>
726    </td>
727  </tr>
728</table>
729<table cellspacing=5 cellpadding=0 border=0>
730  <tr>
731    <td>
732      &nbsp;
733    </td>
734    <td>
735
736<p>
737Returns the string corresponding to a URI id from the URI string pool.
738<p>
739<dl compact><dt><b>
740Parameters: </b><dd>
741<table border=0 cellspacing=2 cellpadding=0>
742<tr><td valign=top><em>uriId</em>&nbsp;</td><td>
743id of the string in the URI string pool. </td></tr>
744</table>
745</dl><dl compact><dt><b>
746Returns: </b><dd>
747URI string corresponding to the URI id. </dl>    </td>
748  </tr>
749</table>
750<a name="z547_3" doxytag="SAX2XMLReader::getValidationConstraintFatal"></a><p>
751<table width="100%" cellpadding="2" cellspacing="0" border="0">
752  <tr>
753    <td class="md">
754      <table cellpadding="0" cellspacing="0" border="0">
755        <tr>
756          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::getValidationConstraintFatal </td>
757          <td class="md" valign="top">(&nbsp;</td>
758          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
759          <td class="md" valign="top">)&nbsp;</td>
760          <td class="md" nowrap> const<code> [pure virtual]</code></td>
761        </tr>
762
763      </table>
764    </td>
765  </tr>
766</table>
767<table cellspacing=5 cellpadding=0 border=0>
768  <tr>
769    <td>
770      &nbsp;
771    </td>
772    <td>
773
774<p>
775This method returns the state of the parser's validation-constraint-fatal flag.
776<p>
777
778<p>
779Or you can query the feature "<a href="http://apache.org/xml/features/validation-error-as-fatal">http://apache.org/xml/features/validation-error-as-fatal</a>" which means the same thing.
780<p>
781<dl compact><dt><b>
782Returns: </b><dd>
783true, if the parser is currently configured to set validation constraint errors as fatal, false otherwise.</dl><dl compact><dt><b>
784See also: </b><dd>
785setValidationContraintFatal , <a class="el" href="classSAX2XMLReader.html#z545_4">getFeature</a> </dl>    </td>
786  </tr>
787</table>
788<a name="z547_0" doxytag="SAX2XMLReader::getValidator"></a><p>
789<table width="100%" cellpadding="2" cellspacing="0" border="0">
790  <tr>
791    <td class="md">
792      <table cellpadding="0" cellspacing="0" border="0">
793        <tr>
794          <td class="md" nowrap valign="top"> virtual <a class="el" href="classXMLValidator.html">XMLValidator</a>* SAX2XMLReader::getValidator </td>
795          <td class="md" valign="top">(&nbsp;</td>
796          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
797          <td class="md" valign="top">)&nbsp;</td>
798          <td class="md" nowrap> const<code> [pure virtual]</code></td>
799        </tr>
800
801      </table>
802    </td>
803  </tr>
804</table>
805<table cellspacing=5 cellpadding=0 border=0>
806  <tr>
807    <td>
808      &nbsp;
809    </td>
810    <td>
811
812<p>
813This method is used to get the current validator.
814<p>
815<b>SAX2XMLReader assumes responsibility for the validator. It will be deleted when the XMLReader is destroyed.</b>
816<p>
817<dl compact><dt><b>
818Returns: </b><dd>
819A pointer to the validator. An application should not deleted the object returned. </dl>    </td>
820  </tr>
821</table>
822<a name="z551_0" doxytag="SAX2XMLReader::installAdvDocHandler"></a><p>
823<table width="100%" cellpadding="2" cellspacing="0" border="0">
824  <tr>
825    <td class="md">
826      <table cellpadding="0" cellspacing="0" border="0">
827        <tr>
828          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::installAdvDocHandler </td>
829          <td class="md" valign="top">(&nbsp;</td>
830          <td class="md" nowrap valign="top"><a class="el" href="classXMLDocumentHandler.html">XMLDocumentHandler</a> *const&nbsp;</td>
831          <td class="mdname1" valign="top" nowrap>&nbsp; <em>toInstall</em>          </td>
832          <td class="md" valign="top">)&nbsp;</td>
833          <td class="md" nowrap><code> [pure virtual]</code></td>
834        </tr>
835
836      </table>
837    </td>
838  </tr>
839</table>
840<table cellspacing=5 cellpadding=0 border=0>
841  <tr>
842    <td>
843      &nbsp;
844    </td>
845    <td>
846
847<p>
848This method installs the specified 'advanced' document callback handler, thereby allowing the user to customize the processing, if they choose to do so.
849<p>
850Any number of advanced callback handlers maybe installed.
851<p>
852
853<p>
854The methods in the advanced callback interface represent Xerces-C extensions. There is no specification for this interface.<dl compact><dt><b>
855Parameters: </b><dd>
856<table border=0 cellspacing=2 cellpadding=0>
857<tr><td valign=top><em>toInstall</em>&nbsp;</td><td>
858A pointer to the users advanced callback handler.</td></tr>
859</table>
860</dl><dl compact><dt><b>
861See also: </b><dd>
862<a class="el" href="classSAX2XMLReader.html#z551_1">removeAdvDocHandler</a> </dl>    </td>
863  </tr>
864</table>
865<a name="z550_2" doxytag="SAX2XMLReader::loadGrammar"></a><p>
866<table width="100%" cellpadding="2" cellspacing="0" border="0">
867  <tr>
868    <td class="md">
869      <table cellpadding="0" cellspacing="0" border="0">
870        <tr>
871          <td class="md" nowrap valign="top"> virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a>* SAX2XMLReader::loadGrammar </td>
872          <td class="md" valign="top">(&nbsp;</td>
873          <td class="md" nowrap valign="top">const char *const&nbsp;</td>
874          <td class="mdname" nowrap>&nbsp; <em>systemId</em>, </td>
875        </tr>
876        <tr>
877          <td></td>
878          <td></td>
879          <td class="md" nowrap>const short&nbsp;</td>
880          <td class="mdname" nowrap>&nbsp; <em>grammarType</em>, </td>
881        </tr>
882        <tr>
883          <td></td>
884          <td></td>
885          <td class="md" nowrap>const bool&nbsp;</td>
886          <td class="mdname" nowrap>&nbsp; <em>toCache</em> = false</td>
887        </tr>
888        <tr>
889          <td></td>
890          <td class="md">)&nbsp;</td>
891          <td class="md" colspan="2"><code> [pure virtual]</code></td>
892        </tr>
893
894      </table>
895    </td>
896  </tr>
897</table>
898<table cellspacing=5 cellpadding=0 border=0>
899  <tr>
900    <td>
901      &nbsp;
902    </td>
903    <td>
904
905<p>
906Preparse schema grammar (XML Schema, DTD, etc.) via a file path or URL.
907<p>
908This method invokes the preparsing process on a schema grammar XML file specified by the file path parameter. If the 'toCache' flag is enabled, the parser will cache the grammars for re-use. If a grammar key is found in the pool, no caching of any grammar will take place.
909<p>
910
911<p>
912<b>"Experimental - subject to change"</b><dl compact><dt><b>
913Parameters: </b><dd>
914<table border=0 cellspacing=2 cellpadding=0>
915<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
916A const char pointer to a native string which contains the path to the XML grammar file to be preparsed. </td></tr>
917<tr><td valign=top><em>grammarType</em>&nbsp;</td><td>
918The grammar type (Schema or DTD). </td></tr>
919<tr><td valign=top><em>toCache</em>&nbsp;</td><td>
920If <code>true</code>, we cache the preparsed grammar, otherwise, no chaching. Default is <code>false</code>. </td></tr>
921</table>
922</dl><dl compact><dt><b>
923Returns: </b><dd>
924The preparsed schema grammar object (SchemaGrammar or DTDGrammar). That grammar object is owned by the parser.</dl><dl compact><dt><b>
925Exceptions: </b><dd>
926<table border=0 cellspacing=2 cellpadding=0>
927<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
928 Any SAX exception, possibly wrapping another exception. </td></tr>
929<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
930 An exception from the parser or client handler code. </td></tr>
931<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
932 A DOM exception as per DOM spec. </td></tr>
933</table>
934</dl>    </td>
935  </tr>
936</table>
937<a name="z550_1" doxytag="SAX2XMLReader::loadGrammar"></a><p>
938<table width="100%" cellpadding="2" cellspacing="0" border="0">
939  <tr>
940    <td class="md">
941      <table cellpadding="0" cellspacing="0" border="0">
942        <tr>
943          <td class="md" nowrap valign="top"> virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a>* SAX2XMLReader::loadGrammar </td>
944          <td class="md" valign="top">(&nbsp;</td>
945          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
946          <td class="mdname" nowrap>&nbsp; <em>systemId</em>, </td>
947        </tr>
948        <tr>
949          <td></td>
950          <td></td>
951          <td class="md" nowrap>const short&nbsp;</td>
952          <td class="mdname" nowrap>&nbsp; <em>grammarType</em>, </td>
953        </tr>
954        <tr>
955          <td></td>
956          <td></td>
957          <td class="md" nowrap>const bool&nbsp;</td>
958          <td class="mdname" nowrap>&nbsp; <em>toCache</em> = false</td>
959        </tr>
960        <tr>
961          <td></td>
962          <td class="md">)&nbsp;</td>
963          <td class="md" colspan="2"><code> [pure virtual]</code></td>
964        </tr>
965
966      </table>
967    </td>
968  </tr>
969</table>
970<table cellspacing=5 cellpadding=0 border=0>
971  <tr>
972    <td>
973      &nbsp;
974    </td>
975    <td>
976
977<p>
978Preparse schema grammar (XML Schema, DTD, etc.) via a file path or URL.
979<p>
980This method invokes the preparsing process on a schema grammar XML file specified by the file path parameter. If the 'toCache' flag is enabled, the parser will cache the grammars for re-use. If a grammar key is found in the pool, no caching of any grammar will take place.
981<p>
982
983<p>
984<b>"Experimental - subject to change"</b><dl compact><dt><b>
985Parameters: </b><dd>
986<table border=0 cellspacing=2 cellpadding=0>
987<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
988A const XMLCh pointer to the Unicode string which contains the path to the XML grammar file to be preparsed. </td></tr>
989<tr><td valign=top><em>grammarType</em>&nbsp;</td><td>
990The grammar type (Schema or DTD). </td></tr>
991<tr><td valign=top><em>toCache</em>&nbsp;</td><td>
992If <code>true</code>, we cache the preparsed grammar, otherwise, no chaching. Default is <code>false</code>. </td></tr>
993</table>
994</dl><dl compact><dt><b>
995Returns: </b><dd>
996The preparsed schema grammar object (SchemaGrammar or DTDGrammar). That grammar object is owned by the parser.</dl><dl compact><dt><b>
997Exceptions: </b><dd>
998<table border=0 cellspacing=2 cellpadding=0>
999<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1000 Any SAX exception, possibly wrapping another exception. </td></tr>
1001<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
1002 An exception from the parser or client handler code. </td></tr>
1003<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1004 A DOM exception as per DOM spec. </td></tr>
1005</table>
1006</dl>    </td>
1007  </tr>
1008</table>
1009<a name="z550_0" doxytag="SAX2XMLReader::loadGrammar"></a><p>
1010<table width="100%" cellpadding="2" cellspacing="0" border="0">
1011  <tr>
1012    <td class="md">
1013      <table cellpadding="0" cellspacing="0" border="0">
1014        <tr>
1015          <td class="md" nowrap valign="top"> virtual <a class="el" href="XSModel_8hpp.html#a1">Grammar</a>* SAX2XMLReader::loadGrammar </td>
1016          <td class="md" valign="top">(&nbsp;</td>
1017          <td class="md" nowrap valign="top">const <a class="el" href="classInputSource.html">InputSource</a> &amp;&nbsp;</td>
1018          <td class="mdname" nowrap>&nbsp; <em>source</em>, </td>
1019        </tr>
1020        <tr>
1021          <td></td>
1022          <td></td>
1023          <td class="md" nowrap>const short&nbsp;</td>
1024          <td class="mdname" nowrap>&nbsp; <em>grammarType</em>, </td>
1025        </tr>
1026        <tr>
1027          <td></td>
1028          <td></td>
1029          <td class="md" nowrap>const bool&nbsp;</td>
1030          <td class="mdname" nowrap>&nbsp; <em>toCache</em> = false</td>
1031        </tr>
1032        <tr>
1033          <td></td>
1034          <td class="md">)&nbsp;</td>
1035          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1036        </tr>
1037
1038      </table>
1039    </td>
1040  </tr>
1041</table>
1042<table cellspacing=5 cellpadding=0 border=0>
1043  <tr>
1044    <td>
1045      &nbsp;
1046    </td>
1047    <td>
1048
1049<p>
1050Preparse schema grammar (XML Schema, DTD, etc.) via an input source object.
1051<p>
1052This method invokes the preparsing process on a schema grammar XML file specified by the SAX <a class="el" href="classInputSource.html">InputSource</a> parameter. If the 'toCache' flag is enabled, the parser will cache the grammars for re-use. If a grammar key is found in the pool, no caching of any grammar will take place.
1053<p>
1054
1055<p>
1056<b>"Experimental - subject to change"</b><dl compact><dt><b>
1057Parameters: </b><dd>
1058<table border=0 cellspacing=2 cellpadding=0>
1059<tr><td valign=top><em>source</em>&nbsp;</td><td>
1060A const reference to the SAX <a class="el" href="classInputSource.html">InputSource</a> object which points to the schema grammar file to be preparsed. </td></tr>
1061<tr><td valign=top><em>grammarType</em>&nbsp;</td><td>
1062The grammar type (Schema or DTD). </td></tr>
1063<tr><td valign=top><em>toCache</em>&nbsp;</td><td>
1064If <code>true</code>, we cache the preparsed grammar, otherwise, no chaching. Default is <code>false</code>. </td></tr>
1065</table>
1066</dl><dl compact><dt><b>
1067Returns: </b><dd>
1068The preparsed schema grammar object (SchemaGrammar or DTDGrammar). That grammar object is owned by the parser.</dl><dl compact><dt><b>
1069Exceptions: </b><dd>
1070<table border=0 cellspacing=2 cellpadding=0>
1071<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1072 Any SAX exception, possibly wrapping another exception. </td></tr>
1073<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
1074 An exception from the parser or client handler code. </td></tr>
1075<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1076 A DOM exception as per DOM spec.</td></tr>
1077</table>
1078</dl><dl compact><dt><b>
1079See also: </b><dd>
1080<a class="el" href="classInputSource.html#z437_0">InputSource::InputSource</a> </dl>    </td>
1081  </tr>
1082</table>
1083<a name="z545_14" doxytag="SAX2XMLReader::parse"></a><p>
1084<table width="100%" cellpadding="2" cellspacing="0" border="0">
1085  <tr>
1086    <td class="md">
1087      <table cellpadding="0" cellspacing="0" border="0">
1088        <tr>
1089          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::parse </td>
1090          <td class="md" valign="top">(&nbsp;</td>
1091          <td class="md" nowrap valign="top">const char *const&nbsp;</td>
1092          <td class="mdname1" valign="top" nowrap>&nbsp; <em>systemId</em>          </td>
1093          <td class="md" valign="top">)&nbsp;</td>
1094          <td class="md" nowrap><code> [pure virtual]</code></td>
1095        </tr>
1096
1097      </table>
1098    </td>
1099  </tr>
1100</table>
1101<table cellspacing=5 cellpadding=0 border=0>
1102  <tr>
1103    <td>
1104      &nbsp;
1105    </td>
1106    <td>
1107
1108<p>
1109Parse an XML document from a system identifier (URI).
1110<p>
1111This method is a shortcut for the common case of reading a document from a system identifier. It is the exact equivalent of the following:
1112<p>
1113parse(new URLInputSource(systemId));
1114<p>
1115If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.<dl compact><dt><b>
1116Parameters: </b><dd>
1117<table border=0 cellspacing=2 cellpadding=0>
1118<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
1119The system identifier (URI). </td></tr>
1120</table>
1121</dl><dl compact><dt><b>
1122Exceptions: </b><dd>
1123<table border=0 cellspacing=2 cellpadding=0>
1124<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1125 Any SAX exception, possibly wrapping another exception. </td></tr>
1126<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
1127 An exception from the parser or client handler code. </td></tr>
1128</table>
1129</dl><dl compact><dt><b>
1130See also: </b><dd>
1131parse(InputSource) </dl>    </td>
1132  </tr>
1133</table>
1134<a name="z545_13" doxytag="SAX2XMLReader::parse"></a><p>
1135<table width="100%" cellpadding="2" cellspacing="0" border="0">
1136  <tr>
1137    <td class="md">
1138      <table cellpadding="0" cellspacing="0" border="0">
1139        <tr>
1140          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::parse </td>
1141          <td class="md" valign="top">(&nbsp;</td>
1142          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
1143          <td class="mdname1" valign="top" nowrap>&nbsp; <em>systemId</em>          </td>
1144          <td class="md" valign="top">)&nbsp;</td>
1145          <td class="md" nowrap><code> [pure virtual]</code></td>
1146        </tr>
1147
1148      </table>
1149    </td>
1150  </tr>
1151</table>
1152<table cellspacing=5 cellpadding=0 border=0>
1153  <tr>
1154    <td>
1155      &nbsp;
1156    </td>
1157    <td>
1158
1159<p>
1160Parse an XML document from a system identifier (URI).
1161<p>
1162This method is a shortcut for the common case of reading a document from a system identifier. It is the exact equivalent of the following:
1163<p>
1164parse(new URLInputSource(systemId));
1165<p>
1166If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.<dl compact><dt><b>
1167Parameters: </b><dd>
1168<table border=0 cellspacing=2 cellpadding=0>
1169<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
1170The system identifier (URI). </td></tr>
1171</table>
1172</dl><dl compact><dt><b>
1173Exceptions: </b><dd>
1174<table border=0 cellspacing=2 cellpadding=0>
1175<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1176 Any SAX exception, possibly wrapping another exception. </td></tr>
1177<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
1178 An exception from the parser or client handler code. </td></tr>
1179</table>
1180</dl><dl compact><dt><b>
1181See also: </b><dd>
1182parse(InputSource) </dl>    </td>
1183  </tr>
1184</table>
1185<a name="z545_12" doxytag="SAX2XMLReader::parse"></a><p>
1186<table width="100%" cellpadding="2" cellspacing="0" border="0">
1187  <tr>
1188    <td class="md">
1189      <table cellpadding="0" cellspacing="0" border="0">
1190        <tr>
1191          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::parse </td>
1192          <td class="md" valign="top">(&nbsp;</td>
1193          <td class="md" nowrap valign="top">const <a class="el" href="classInputSource.html">InputSource</a> &amp;&nbsp;</td>
1194          <td class="mdname1" valign="top" nowrap>&nbsp; <em>source</em>          </td>
1195          <td class="md" valign="top">)&nbsp;</td>
1196          <td class="md" nowrap><code> [pure virtual]</code></td>
1197        </tr>
1198
1199      </table>
1200    </td>
1201  </tr>
1202</table>
1203<table cellspacing=5 cellpadding=0 border=0>
1204  <tr>
1205    <td>
1206      &nbsp;
1207    </td>
1208    <td>
1209
1210<p>
1211Parse an XML document.
1212<p>
1213The application can use this method to instruct the SAX parser to begin parsing an XML document from any valid input source (a character stream, a byte stream, or a URI).
1214<p>
1215Applications may not invoke this method while a parse is in progress (they should create a new <a class="el" href="classParser.html">Parser</a> instead for each additional XML document). Once a parse is complete, an application may reuse the same <a class="el" href="classParser.html">Parser</a> object, possibly with a different input source.<dl compact><dt><b>
1216Parameters: </b><dd>
1217<table border=0 cellspacing=2 cellpadding=0>
1218<tr><td valign=top><em>source</em>&nbsp;</td><td>
1219The input source for the top-level of the XML document. </td></tr>
1220</table>
1221</dl><dl compact><dt><b>
1222Exceptions: </b><dd>
1223<table border=0 cellspacing=2 cellpadding=0>
1224<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1225 Any SAX exception, possibly wrapping another exception. </td></tr>
1226<tr><td valign=top><em><a class="el" href="classXMLException.html">XMLException</a></em>&nbsp;</td><td>
1227 An exception from the parser or client handler code. </td></tr>
1228</table>
1229</dl><dl compact><dt><b>
1230See also: </b><dd>
1231<a class="el" href="classInputSource.html#z437_0">InputSource::InputSource</a> , <a class="el" href="classSAX2XMLReader.html#z545_8">setEntityResolver</a> , <a class="el" href="classSAX2XMLReader.html#z545_7">setDTDHandler</a> , setDocumentHandler , <a class="el" href="classSAX2XMLReader.html#z545_9">setErrorHandler</a> </dl>    </td>
1232  </tr>
1233</table>
1234<a name="z549_2" doxytag="SAX2XMLReader::parseFirst"></a><p>
1235<table width="100%" cellpadding="2" cellspacing="0" border="0">
1236  <tr>
1237    <td class="md">
1238      <table cellpadding="0" cellspacing="0" border="0">
1239        <tr>
1240          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::parseFirst </td>
1241          <td class="md" valign="top">(&nbsp;</td>
1242          <td class="md" nowrap valign="top">const <a class="el" href="classInputSource.html">InputSource</a> &amp;&nbsp;</td>
1243          <td class="mdname" nowrap>&nbsp; <em>source</em>, </td>
1244        </tr>
1245        <tr>
1246          <td></td>
1247          <td></td>
1248          <td class="md" nowrap><a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;&nbsp;</td>
1249          <td class="mdname" nowrap>&nbsp; <em>toFill</em></td>
1250        </tr>
1251        <tr>
1252          <td></td>
1253          <td class="md">)&nbsp;</td>
1254          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1255        </tr>
1256
1257      </table>
1258    </td>
1259  </tr>
1260</table>
1261<table cellspacing=5 cellpadding=0 border=0>
1262  <tr>
1263    <td>
1264      &nbsp;
1265    </td>
1266    <td>
1267
1268<p>
1269Begin a progressive parse operation.
1270<p>
1271This method is used to start a progressive parse on a XML file. To continue parsing, subsequent calls must be to the parseNext method.
1272<p>
1273It scans through the prolog and returns a token to be used on subsequent scanNext() calls. If the return value is true, then the token is legal and ready for further use. If it returns false, then the scan of the prolog failed and the token is not going to work on subsequent scanNext() calls.<dl compact><dt><b>
1274Parameters: </b><dd>
1275<table border=0 cellspacing=2 cellpadding=0>
1276<tr><td valign=top><em>source</em>&nbsp;</td><td>
1277A const reference to the <a class="el" href="classInputSource.html">InputSource</a> object which points to the XML file to be parsed. </td></tr>
1278<tr><td valign=top><em>toFill</em>&nbsp;</td><td>
1279A token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.</td></tr>
1280</table>
1281</dl><dl compact><dt><b>
1282Returns: </b><dd>
1283'true', if successful in parsing the prolog. It indicates the user can go ahead with parsing the rest of the file. It returns 'false' to indicate that the parser could not parse the prolog.</dl><dl compact><dt><b>
1284See also: </b><dd>
1285<a class="el" href="classSAX2XMLReader.html#z549_3">parseNext</a> , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(XMLCh*,...) , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(char*,...) </dl>    </td>
1286  </tr>
1287</table>
1288<a name="z549_1" doxytag="SAX2XMLReader::parseFirst"></a><p>
1289<table width="100%" cellpadding="2" cellspacing="0" border="0">
1290  <tr>
1291    <td class="md">
1292      <table cellpadding="0" cellspacing="0" border="0">
1293        <tr>
1294          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::parseFirst </td>
1295          <td class="md" valign="top">(&nbsp;</td>
1296          <td class="md" nowrap valign="top">const char *const&nbsp;</td>
1297          <td class="mdname" nowrap>&nbsp; <em>systemId</em>, </td>
1298        </tr>
1299        <tr>
1300          <td></td>
1301          <td></td>
1302          <td class="md" nowrap><a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;&nbsp;</td>
1303          <td class="mdname" nowrap>&nbsp; <em>toFill</em></td>
1304        </tr>
1305        <tr>
1306          <td></td>
1307          <td class="md">)&nbsp;</td>
1308          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1309        </tr>
1310
1311      </table>
1312    </td>
1313  </tr>
1314</table>
1315<table cellspacing=5 cellpadding=0 border=0>
1316  <tr>
1317    <td>
1318      &nbsp;
1319    </td>
1320    <td>
1321
1322<p>
1323Begin a progressive parse operation.
1324<p>
1325This method is used to start a progressive parse on a XML file. To continue parsing, subsequent calls must be to the parseNext method.
1326<p>
1327It scans through the prolog and returns a token to be used on subsequent scanNext() calls. If the return value is true, then the token is legal and ready for further use. If it returns false, then the scan of the prolog failed and the token is not going to work on subsequent scanNext() calls.<dl compact><dt><b>
1328Parameters: </b><dd>
1329<table border=0 cellspacing=2 cellpadding=0>
1330<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
1331A pointer to a regular native string represting the path to the XML file to be parsed. </td></tr>
1332<tr><td valign=top><em>toFill</em>&nbsp;</td><td>
1333A token maintaing state information to maintain internal consIstency between invocation of 'parseNext' calls.</td></tr>
1334</table>
1335</dl><dl compact><dt><b>
1336Returns: </b><dd>
1337'true', if successful in parsing the prolog. It indicates the user can go ahead with parsing the rest of the file. It returns 'false' to indicate that the parser could not parse the prolog.</dl><dl compact><dt><b>
1338See also: </b><dd>
1339<a class="el" href="classSAX2XMLReader.html#z549_3">parseNext</a> , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(XMLCh*,...) , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(<a class="el" href="classInputSource.html">InputSource</a>&amp;,...) </dl>    </td>
1340  </tr>
1341</table>
1342<a name="z549_0" doxytag="SAX2XMLReader::parseFirst"></a><p>
1343<table width="100%" cellpadding="2" cellspacing="0" border="0">
1344  <tr>
1345    <td class="md">
1346      <table cellpadding="0" cellspacing="0" border="0">
1347        <tr>
1348          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::parseFirst </td>
1349          <td class="md" valign="top">(&nbsp;</td>
1350          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
1351          <td class="mdname" nowrap>&nbsp; <em>systemId</em>, </td>
1352        </tr>
1353        <tr>
1354          <td></td>
1355          <td></td>
1356          <td class="md" nowrap><a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;&nbsp;</td>
1357          <td class="mdname" nowrap>&nbsp; <em>toFill</em></td>
1358        </tr>
1359        <tr>
1360          <td></td>
1361          <td class="md">)&nbsp;</td>
1362          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1363        </tr>
1364
1365      </table>
1366    </td>
1367  </tr>
1368</table>
1369<table cellspacing=5 cellpadding=0 border=0>
1370  <tr>
1371    <td>
1372      &nbsp;
1373    </td>
1374    <td>
1375
1376<p>
1377Begin a progressive parse operation.
1378<p>
1379This method is used to start a progressive parse on a XML file. To continue parsing, subsequent calls must be to the parseNext method.
1380<p>
1381It scans through the prolog and returns a token to be used on subsequent scanNext() calls. If the return value is true, then the token is legal and ready for further use. If it returns false, then the scan of the prolog failed and the token is not going to work on subsequent scanNext() calls.<dl compact><dt><b>
1382Parameters: </b><dd>
1383<table border=0 cellspacing=2 cellpadding=0>
1384<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
1385A pointer to a Unicode string represting the path to the XML file to be parsed. </td></tr>
1386<tr><td valign=top><em>toFill</em>&nbsp;</td><td>
1387A token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.</td></tr>
1388</table>
1389</dl><dl compact><dt><b>
1390Returns: </b><dd>
1391'true', if successful in parsing the prolog. It indicates the user can go ahead with parsing the rest of the file. It returns 'false' to indicate that the parser could parse the prolog (which means the token will not be valid.)</dl><dl compact><dt><b>
1392See also: </b><dd>
1393<a class="el" href="classSAX2XMLReader.html#z549_3">parseNext</a> , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(char*,...) , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(<a class="el" href="classInputSource.html">InputSource</a>&amp;,...) </dl>    </td>
1394  </tr>
1395</table>
1396<a name="z549_3" doxytag="SAX2XMLReader::parseNext"></a><p>
1397<table width="100%" cellpadding="2" cellspacing="0" border="0">
1398  <tr>
1399    <td class="md">
1400      <table cellpadding="0" cellspacing="0" border="0">
1401        <tr>
1402          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::parseNext </td>
1403          <td class="md" valign="top">(&nbsp;</td>
1404          <td class="md" nowrap valign="top"><a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;&nbsp;</td>
1405          <td class="mdname1" valign="top" nowrap>&nbsp; <em>token</em>          </td>
1406          <td class="md" valign="top">)&nbsp;</td>
1407          <td class="md" nowrap><code> [pure virtual]</code></td>
1408        </tr>
1409
1410      </table>
1411    </td>
1412  </tr>
1413</table>
1414<table cellspacing=5 cellpadding=0 border=0>
1415  <tr>
1416    <td>
1417      &nbsp;
1418    </td>
1419    <td>
1420
1421<p>
1422Continue a progressive parse operation.
1423<p>
1424This method is used to continue with progressive parsing of XML files started by a call to 'parseFirst' method.
1425<p>
1426It parses the XML file and stops as soon as it comes across a XML token (as defined in the XML specification). Relevant callback handlers are invoked as required by the SAX specification.<dl compact><dt><b>
1427Parameters: </b><dd>
1428<table border=0 cellspacing=2 cellpadding=0>
1429<tr><td valign=top><em>token</em>&nbsp;</td><td>
1430A token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls.</td></tr>
1431</table>
1432</dl><dl compact><dt><b>
1433Returns: </b><dd>
1434'true', if successful in parsing the next XML token. It indicates the user can go ahead with parsing the rest of the file. It returns 'false' to indicate that the parser could not find next token as per the XML specification production rule.</dl><dl compact><dt><b>
1435See also: </b><dd>
1436<a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(XMLCh*,...) , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(char*,...) , <a class="el" href="classSAX2XMLReader.html#z549_0">parseFirst</a>(<a class="el" href="classInputSource.html">InputSource</a>&amp;,...) </dl>    </td>
1437  </tr>
1438</table>
1439<a name="z549_4" doxytag="SAX2XMLReader::parseReset"></a><p>
1440<table width="100%" cellpadding="2" cellspacing="0" border="0">
1441  <tr>
1442    <td class="md">
1443      <table cellpadding="0" cellspacing="0" border="0">
1444        <tr>
1445          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::parseReset </td>
1446          <td class="md" valign="top">(&nbsp;</td>
1447          <td class="md" nowrap valign="top"><a class="el" href="AbstractDOMParser_8hpp.html#a1">XMLPScanToken</a> &amp;&nbsp;</td>
1448          <td class="mdname1" valign="top" nowrap>&nbsp; <em>token</em>          </td>
1449          <td class="md" valign="top">)&nbsp;</td>
1450          <td class="md" nowrap><code> [pure virtual]</code></td>
1451        </tr>
1452
1453      </table>
1454    </td>
1455  </tr>
1456</table>
1457<table cellspacing=5 cellpadding=0 border=0>
1458  <tr>
1459    <td>
1460      &nbsp;
1461    </td>
1462    <td>
1463
1464<p>
1465Reset the parser after a progressive parse.
1466<p>
1467If a progressive parse loop exits before the end of the document is reached, the parser has no way of knowing this. So it will leave open any files or sockets or memory buffers that were in use at the time that the parse loop exited.
1468<p>
1469The next parse operation will cause these open files and such to be closed, but the next parse operation might occur at some unknown future point. To avoid this problem, you should reset the parser if you exit the loop early.
1470<p>
1471If you exited because of an error, then this cleanup will be done for you. Its only when you exit the file prematurely of your own accord, because you've found what you wanted in the file most likely.<dl compact><dt><b>
1472Parameters: </b><dd>
1473<table border=0 cellspacing=2 cellpadding=0>
1474<tr><td valign=top><em>token</em>&nbsp;</td><td>
1475A token maintaing state information to maintain internal consistency between invocation of 'parseNext' calls. </td></tr>
1476</table>
1477</dl>    </td>
1478  </tr>
1479</table>
1480<a name="z551_1" doxytag="SAX2XMLReader::removeAdvDocHandler"></a><p>
1481<table width="100%" cellpadding="2" cellspacing="0" border="0">
1482  <tr>
1483    <td class="md">
1484      <table cellpadding="0" cellspacing="0" border="0">
1485        <tr>
1486          <td class="md" nowrap valign="top"> virtual bool SAX2XMLReader::removeAdvDocHandler </td>
1487          <td class="md" valign="top">(&nbsp;</td>
1488          <td class="md" nowrap valign="top"><a class="el" href="classXMLDocumentHandler.html">XMLDocumentHandler</a> *const&nbsp;</td>
1489          <td class="mdname1" valign="top" nowrap>&nbsp; <em>toRemove</em>          </td>
1490          <td class="md" valign="top">)&nbsp;</td>
1491          <td class="md" nowrap><code> [pure virtual]</code></td>
1492        </tr>
1493
1494      </table>
1495    </td>
1496  </tr>
1497</table>
1498<table cellspacing=5 cellpadding=0 border=0>
1499  <tr>
1500    <td>
1501      &nbsp;
1502    </td>
1503    <td>
1504
1505<p>
1506This method removes the 'advanced' document handler callback from the underlying parser scanner.
1507<p>
1508If no handler is installed, advanced callbacks are not invoked by the scanner. <dl compact><dt><b>
1509Parameters: </b><dd>
1510<table border=0 cellspacing=2 cellpadding=0>
1511<tr><td valign=top><em>toRemove</em>&nbsp;</td><td>
1512A pointer to the advanced callback handler which should be removed.</td></tr>
1513</table>
1514</dl><dl compact><dt><b>
1515See also: </b><dd>
1516<a class="el" href="classSAX2XMLReader.html#z551_0">installAdvDocHandler</a> </dl>    </td>
1517  </tr>
1518</table>
1519<a name="z550_3" doxytag="SAX2XMLReader::resetCachedGrammarPool"></a><p>
1520<table width="100%" cellpadding="2" cellspacing="0" border="0">
1521  <tr>
1522    <td class="md">
1523      <table cellpadding="0" cellspacing="0" border="0">
1524        <tr>
1525          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::resetCachedGrammarPool </td>
1526          <td class="md" valign="top">(&nbsp;</td>
1527          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1528          <td class="md" valign="top">)&nbsp;</td>
1529          <td class="md" nowrap><code> [pure virtual]</code></td>
1530        </tr>
1531
1532      </table>
1533    </td>
1534  </tr>
1535</table>
1536<table cellspacing=5 cellpadding=0 border=0>
1537  <tr>
1538    <td>
1539      &nbsp;
1540    </td>
1541    <td>
1542
1543<p>
1544Clear the cached grammar pool.
1545<p>
1546    </td>
1547  </tr>
1548</table>
1549<a name="z545_6" doxytag="SAX2XMLReader::setContentHandler"></a><p>
1550<table width="100%" cellpadding="2" cellspacing="0" border="0">
1551  <tr>
1552    <td class="md">
1553      <table cellpadding="0" cellspacing="0" border="0">
1554        <tr>
1555          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setContentHandler </td>
1556          <td class="md" valign="top">(&nbsp;</td>
1557          <td class="md" nowrap valign="top"><a class="el" href="classContentHandler.html">ContentHandler</a> *const&nbsp;</td>
1558          <td class="mdname1" valign="top" nowrap>&nbsp; <em>handler</em>          </td>
1559          <td class="md" valign="top">)&nbsp;</td>
1560          <td class="md" nowrap><code> [pure virtual]</code></td>
1561        </tr>
1562
1563      </table>
1564    </td>
1565  </tr>
1566</table>
1567<table cellspacing=5 cellpadding=0 border=0>
1568  <tr>
1569    <td>
1570      &nbsp;
1571    </td>
1572    <td>
1573
1574<p>
1575Allow an application to register a document event handler.
1576<p>
1577If the application does not register a document handler, all document events reported by the SAX parser will be silently ignored (this is the default behaviour implemented by <a class="el" href="classHandlerBase.html">HandlerBase</a>).
1578<p>
1579Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.<dl compact><dt><b>
1580Parameters: </b><dd>
1581<table border=0 cellspacing=2 cellpadding=0>
1582<tr><td valign=top><em>handler</em>&nbsp;</td><td>
1583The document handler. </td></tr>
1584</table>
1585</dl><dl compact><dt><b>
1586See also: </b><dd>
1587<a class="el" href="classDocumentHandler.html#z420_0">DocumentHandler::DocumentHandler</a> , <a class="el" href="classHandlerBase.html#a0">HandlerBase::HandlerBase</a> </dl>    </td>
1588  </tr>
1589</table>
1590<a name="z546_2" doxytag="SAX2XMLReader::setDeclarationHandler"></a><p>
1591<table width="100%" cellpadding="2" cellspacing="0" border="0">
1592  <tr>
1593    <td class="md">
1594      <table cellpadding="0" cellspacing="0" border="0">
1595        <tr>
1596          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setDeclarationHandler </td>
1597          <td class="md" valign="top">(&nbsp;</td>
1598          <td class="md" nowrap valign="top"><a class="el" href="classDeclHandler.html">DeclHandler</a> *const&nbsp;</td>
1599          <td class="mdname1" valign="top" nowrap>&nbsp; <em>handler</em>          </td>
1600          <td class="md" valign="top">)&nbsp;</td>
1601          <td class="md" nowrap><code> [pure virtual]</code></td>
1602        </tr>
1603
1604      </table>
1605    </td>
1606  </tr>
1607</table>
1608<table cellspacing=5 cellpadding=0 border=0>
1609  <tr>
1610    <td>
1611      &nbsp;
1612    </td>
1613    <td>
1614
1615<p>
1616Allow an application to register a declaration event handler.
1617<p>
1618If the application does not register a declaration handler, all events reported by the SAX parser will be silently ignored. (this is the default behaviour implemented by <a class="el" href="classDefaultHandler.html">DefaultHandler</a>).
1619<p>
1620Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.<dl compact><dt><b>
1621Parameters: </b><dd>
1622<table border=0 cellspacing=2 cellpadding=0>
1623<tr><td valign=top><em>handler</em>&nbsp;</td><td>
1624The DTD declaration handler. </td></tr>
1625</table>
1626</dl><dl compact><dt><b>
1627See also: </b><dd>
1628<a class="el" href="classDeclHandler.html#z532_0">DeclHandler::DeclHandler</a> , <a class="el" href="classSAXException.html#z442_0">SAXException::SAXException</a> , <a class="el" href="classDefaultHandler.html#a0">DefaultHandler::DefaultHandler</a> </dl>    </td>
1629  </tr>
1630</table>
1631<a name="z545_7" doxytag="SAX2XMLReader::setDTDHandler"></a><p>
1632<table width="100%" cellpadding="2" cellspacing="0" border="0">
1633  <tr>
1634    <td class="md">
1635      <table cellpadding="0" cellspacing="0" border="0">
1636        <tr>
1637          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setDTDHandler </td>
1638          <td class="md" valign="top">(&nbsp;</td>
1639          <td class="md" nowrap valign="top"><a class="el" href="classDTDHandler.html">DTDHandler</a> *const&nbsp;</td>
1640          <td class="mdname1" valign="top" nowrap>&nbsp; <em>handler</em>          </td>
1641          <td class="md" valign="top">)&nbsp;</td>
1642          <td class="md" nowrap><code> [pure virtual]</code></td>
1643        </tr>
1644
1645      </table>
1646    </td>
1647  </tr>
1648</table>
1649<table cellspacing=5 cellpadding=0 border=0>
1650  <tr>
1651    <td>
1652      &nbsp;
1653    </td>
1654    <td>
1655
1656<p>
1657Allow an application to register a DTD event handler.
1658<p>
1659If the application does not register a DTD handler, all DTD events reported by the SAX parser will be silently ignored (this is the default behaviour implemented by <a class="el" href="classHandlerBase.html">HandlerBase</a>).
1660<p>
1661Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.<dl compact><dt><b>
1662Parameters: </b><dd>
1663<table border=0 cellspacing=2 cellpadding=0>
1664<tr><td valign=top><em>handler</em>&nbsp;</td><td>
1665The DTD handler. </td></tr>
1666</table>
1667</dl><dl compact><dt><b>
1668See also: </b><dd>
1669<a class="el" href="classDTDHandler.html#z422_0">DTDHandler::DTDHandler</a> , <a class="el" href="classHandlerBase.html#a0">HandlerBase::HandlerBase</a> </dl>    </td>
1670  </tr>
1671</table>
1672<a name="z545_8" doxytag="SAX2XMLReader::setEntityResolver"></a><p>
1673<table width="100%" cellpadding="2" cellspacing="0" border="0">
1674  <tr>
1675    <td class="md">
1676      <table cellpadding="0" cellspacing="0" border="0">
1677        <tr>
1678          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setEntityResolver </td>
1679          <td class="md" valign="top">(&nbsp;</td>
1680          <td class="md" nowrap valign="top"><a class="el" href="classEntityResolver.html">EntityResolver</a> *const&nbsp;</td>
1681          <td class="mdname1" valign="top" nowrap>&nbsp; <em>resolver</em>          </td>
1682          <td class="md" valign="top">)&nbsp;</td>
1683          <td class="md" nowrap><code> [pure virtual]</code></td>
1684        </tr>
1685
1686      </table>
1687    </td>
1688  </tr>
1689</table>
1690<table cellspacing=5 cellpadding=0 border=0>
1691  <tr>
1692    <td>
1693      &nbsp;
1694    </td>
1695    <td>
1696
1697<p>
1698Allow an application to register a custom entity resolver.
1699<p>
1700If the application does not register an entity resolver, the SAX parser will resolve system identifiers and open connections to entities itself (this is the default behaviour implemented in <a class="el" href="classDefaultHandler.html">DefaultHandler</a>).
1701<p>
1702Applications may register a new or different entity resolver in the middle of a parse, and the SAX parser must begin using the new resolver immediately.<dl compact><dt><b>
1703Parameters: </b><dd>
1704<table border=0 cellspacing=2 cellpadding=0>
1705<tr><td valign=top><em>resolver</em>&nbsp;</td><td>
1706The object for resolving entities. </td></tr>
1707</table>
1708</dl><dl compact><dt><b>
1709See also: </b><dd>
1710<a class="el" href="classEntityResolver.html#z424_0">EntityResolver::EntityResolver</a> , <a class="el" href="classDefaultHandler.html#a0">DefaultHandler::DefaultHandler</a> </dl>    </td>
1711  </tr>
1712</table>
1713<a name="z545_9" doxytag="SAX2XMLReader::setErrorHandler"></a><p>
1714<table width="100%" cellpadding="2" cellspacing="0" border="0">
1715  <tr>
1716    <td class="md">
1717      <table cellpadding="0" cellspacing="0" border="0">
1718        <tr>
1719          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setErrorHandler </td>
1720          <td class="md" valign="top">(&nbsp;</td>
1721          <td class="md" nowrap valign="top"><a class="el" href="classErrorHandler.html">ErrorHandler</a> *const&nbsp;</td>
1722          <td class="mdname1" valign="top" nowrap>&nbsp; <em>handler</em>          </td>
1723          <td class="md" valign="top">)&nbsp;</td>
1724          <td class="md" nowrap><code> [pure virtual]</code></td>
1725        </tr>
1726
1727      </table>
1728    </td>
1729  </tr>
1730</table>
1731<table cellspacing=5 cellpadding=0 border=0>
1732  <tr>
1733    <td>
1734      &nbsp;
1735    </td>
1736    <td>
1737
1738<p>
1739Allow an application to register an error event handler.
1740<p>
1741If the application does not register an error event handler, all error events reported by the SAX parser will be silently ignored, except for fatalError, which will throw a <a class="el" href="classSAXException.html">SAXException</a> (this is the default behaviour implemented by <a class="el" href="classHandlerBase.html">HandlerBase</a>).
1742<p>
1743Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.<dl compact><dt><b>
1744Parameters: </b><dd>
1745<table border=0 cellspacing=2 cellpadding=0>
1746<tr><td valign=top><em>handler</em>&nbsp;</td><td>
1747The error handler. </td></tr>
1748</table>
1749</dl><dl compact><dt><b>
1750See also: </b><dd>
1751<a class="el" href="classErrorHandler.html#z426_0">ErrorHandler::ErrorHandler</a> , <a class="el" href="classSAXException.html#z442_0">SAXException::SAXException</a> , <a class="el" href="classHandlerBase.html#a0">HandlerBase::HandlerBase</a> </dl>    </td>
1752  </tr>
1753</table>
1754<a name="z548_1" doxytag="SAX2XMLReader::setExitOnFirstFatalError"></a><p>
1755<table width="100%" cellpadding="2" cellspacing="0" border="0">
1756  <tr>
1757    <td class="md">
1758      <table cellpadding="0" cellspacing="0" border="0">
1759        <tr>
1760          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setExitOnFirstFatalError </td>
1761          <td class="md" valign="top">(&nbsp;</td>
1762          <td class="md" nowrap valign="top">const bool&nbsp;</td>
1763          <td class="mdname1" valign="top" nowrap>&nbsp; <em>newState</em>          </td>
1764          <td class="md" valign="top">)&nbsp;</td>
1765          <td class="md" nowrap><code> [pure virtual]</code></td>
1766        </tr>
1767
1768      </table>
1769    </td>
1770  </tr>
1771</table>
1772<table cellspacing=5 cellpadding=0 border=0>
1773  <tr>
1774    <td>
1775      &nbsp;
1776    </td>
1777    <td>
1778
1779<p>
1780This method allows users to set the parser's behaviour when it encounters the first fatal error.
1781<p>
1782If set to true, the parser will exit at the first fatal error. If false, then it will report the error and continue processing.
1783<p>
1784
1785<p>
1786The default value is 'true' and the parser exits on the first fatal error.
1787<p>
1788
1789<p>
1790Or you can set the feature "<a href="http://apache.org/xml/features/continue-after-fatal-error">http://apache.org/xml/features/continue-after-fatal-error</a>" which has the opposite behaviour.
1791<p>
1792
1793<p>
1794If both the feature above and this function are used, the latter takes effect.<dl compact><dt><b>
1795Parameters: </b><dd>
1796<table border=0 cellspacing=2 cellpadding=0>
1797<tr><td valign=top><em>newState</em>&nbsp;</td><td>
1798The value specifying whether the parser should continue or exit when it encounters the first fatal error.</td></tr>
1799</table>
1800</dl><dl compact><dt><b>
1801See also: </b><dd>
1802<a class="el" href="classSAX2XMLReader.html#z547_2">getExitOnFirstFatalError</a> , <a class="el" href="classSAX2XMLReader.html#z545_10">setFeature</a> </dl>    </td>
1803  </tr>
1804</table>
1805<a name="z545_10" doxytag="SAX2XMLReader::setFeature"></a><p>
1806<table width="100%" cellpadding="2" cellspacing="0" border="0">
1807  <tr>
1808    <td class="md">
1809      <table cellpadding="0" cellspacing="0" border="0">
1810        <tr>
1811          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setFeature </td>
1812          <td class="md" valign="top">(&nbsp;</td>
1813          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
1814          <td class="mdname" nowrap>&nbsp; <em>name</em>, </td>
1815        </tr>
1816        <tr>
1817          <td></td>
1818          <td></td>
1819          <td class="md" nowrap>const bool&nbsp;</td>
1820          <td class="mdname" nowrap>&nbsp; <em>value</em></td>
1821        </tr>
1822        <tr>
1823          <td></td>
1824          <td class="md">)&nbsp;</td>
1825          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1826        </tr>
1827
1828      </table>
1829    </td>
1830  </tr>
1831</table>
1832<table cellspacing=5 cellpadding=0 border=0>
1833  <tr>
1834    <td>
1835      &nbsp;
1836    </td>
1837    <td>
1838
1839<p>
1840Set the state of any feature in a SAX2 XMLReader.
1841<p>
1842Supported features in SAX2 for xerces-c are: <br>
1843(See <a href="http://xml.apache.org/xerces-c/program-sax2.html#SAX2Features">http://xml.apache.org/xerces-c/program-sax2.html#SAX2Features</a> for detail description).
1844<p>
1845<br>
1846<a href="http://xml.org/sax/features/validation">http://xml.org/sax/features/validation</a> (default: true) <br>
1847<a href="http://xml.org/sax/features/namespaces">http://xml.org/sax/features/namespaces</a> (default: true) <br>
1848<a href="http://xml.org/sax/features/namespace-prefixes">http://xml.org/sax/features/namespace-prefixes</a> (default: false) <br>
1849<a href="http://apache.org/xml/features/validation/dynamic">http://apache.org/xml/features/validation/dynamic</a> (default: false) <br>
1850<a href="http://apache.org/xml/features/validation/reuse-grammar">http://apache.org/xml/features/validation/reuse-grammar</a> (default: false) <br>
1851<a href="http://apache.org/xml/features/validation/schema">http://apache.org/xml/features/validation/schema</a> (default: true) <br>
1852<a href="http://apache.org/xml/features/validation/schema-full-checking">http://apache.org/xml/features/validation/schema-full-checking</a> (default: false) <br>
1853<a href="http://apache.org/xml/features/nonvalidating/load-external-dtd">http://apache.org/xml/features/nonvalidating/load-external-dtd</a> (default: true) <br>
1854<a href="http://apache.org/xml/features/continue-after-fatal-error">http://apache.org/xml/features/continue-after-fatal-error</a> (default: false) <br>
1855<a href="http://apache.org/xml/features/validation-error-as-fatal">http://apache.org/xml/features/validation-error-as-fatal</a> (default: false) <br>
1856<a href="http://apache.org/xml/features/validation/reuse-validator">http://apache.org/xml/features/validation/reuse-validator</a> (Deprecated) (default: false)<dl compact><dt><b>
1857Parameters: </b><dd>
1858<table border=0 cellspacing=2 cellpadding=0>
1859<tr><td valign=top><em>name</em>&nbsp;</td><td>
1860The unique identifier (URI) of the feature. </td></tr>
1861<tr><td valign=top><em>value</em>&nbsp;</td><td>
1862The requested state of the feature (true or false). </td></tr>
1863</table>
1864</dl><dl compact><dt><b>
1865Exceptions: </b><dd>
1866<table border=0 cellspacing=2 cellpadding=0>
1867<tr><td valign=top><em><a class="el" href="classSAXNotRecognizedException.html">SAXNotRecognizedException</a></em>&nbsp;</td><td>
1868 If the requested feature is not known. </td></tr>
1869<tr><td valign=top><em><a class="el" href="classSAXNotSupportedException.html">SAXNotSupportedException</a></em>&nbsp;</td><td>
1870 Feature modification is not supported during parse </td></tr>
1871</table>
1872</dl>    </td>
1873  </tr>
1874</table>
1875<a name="z550_4" doxytag="SAX2XMLReader::setInputBufferSize"></a><p>
1876<table width="100%" cellpadding="2" cellspacing="0" border="0">
1877  <tr>
1878    <td class="md">
1879      <table cellpadding="0" cellspacing="0" border="0">
1880        <tr>
1881          <td class="md" nowrap valign="top"> void SAX2XMLReader::setInputBufferSize </td>
1882          <td class="md" valign="top">(&nbsp;</td>
1883          <td class="md" nowrap valign="top">const size_t&nbsp;</td>
1884          <td class="mdname1" valign="top" nowrap>&nbsp; <em>bufferSize</em>          </td>
1885          <td class="md" valign="top">)&nbsp;</td>
1886          <td class="md" nowrap></td>
1887        </tr>
1888
1889      </table>
1890    </td>
1891  </tr>
1892</table>
1893<table cellspacing=5 cellpadding=0 border=0>
1894  <tr>
1895    <td>
1896      &nbsp;
1897    </td>
1898    <td>
1899
1900<p>
1901Set maximum input buffer size.
1902<p>
1903This method allows users to limit the size of buffers used in parsing XML character data. The effect of setting this size is to limit the size of a <a class="el" href="classContentHandler.html#z531_0">ContentHandler::characters</a>() call.
1904<p>
1905The parser's default input buffer size is 1 megabyte.<dl compact><dt><b>
1906Parameters: </b><dd>
1907<table border=0 cellspacing=2 cellpadding=0>
1908<tr><td valign=top><em>bufferSize</em>&nbsp;</td><td>
1909The maximum input buffer size </td></tr>
1910</table>
1911</dl>    </td>
1912  </tr>
1913</table>
1914<a name="z546_3" doxytag="SAX2XMLReader::setLexicalHandler"></a><p>
1915<table width="100%" cellpadding="2" cellspacing="0" border="0">
1916  <tr>
1917    <td class="md">
1918      <table cellpadding="0" cellspacing="0" border="0">
1919        <tr>
1920          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setLexicalHandler </td>
1921          <td class="md" valign="top">(&nbsp;</td>
1922          <td class="md" nowrap valign="top"><a class="el" href="classLexicalHandler.html">LexicalHandler</a> *const&nbsp;</td>
1923          <td class="mdname1" valign="top" nowrap>&nbsp; <em>handler</em>          </td>
1924          <td class="md" valign="top">)&nbsp;</td>
1925          <td class="md" nowrap><code> [pure virtual]</code></td>
1926        </tr>
1927
1928      </table>
1929    </td>
1930  </tr>
1931</table>
1932<table cellspacing=5 cellpadding=0 border=0>
1933  <tr>
1934    <td>
1935      &nbsp;
1936    </td>
1937    <td>
1938
1939<p>
1940Allow an application to register a lexical event handler.
1941<p>
1942If the application does not register a lexical handler, all events reported by the SAX parser will be silently ignored. (this is the default behaviour implemented by <a class="el" href="classHandlerBase.html">HandlerBase</a>).
1943<p>
1944Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.<dl compact><dt><b>
1945Parameters: </b><dd>
1946<table border=0 cellspacing=2 cellpadding=0>
1947<tr><td valign=top><em>handler</em>&nbsp;</td><td>
1948The error handler. </td></tr>
1949</table>
1950</dl><dl compact><dt><b>
1951See also: </b><dd>
1952<a class="el" href="classLexicalHandler.html#z541_0">LexicalHandler::LexicalHandler</a> , <a class="el" href="classSAXException.html#z442_0">SAXException::SAXException</a> , <a class="el" href="classHandlerBase.html#a0">HandlerBase::HandlerBase</a> </dl>    </td>
1953  </tr>
1954</table>
1955<a name="z545_11" doxytag="SAX2XMLReader::setProperty"></a><p>
1956<table width="100%" cellpadding="2" cellspacing="0" border="0">
1957  <tr>
1958    <td class="md">
1959      <table cellpadding="0" cellspacing="0" border="0">
1960        <tr>
1961          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setProperty </td>
1962          <td class="md" valign="top">(&nbsp;</td>
1963          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
1964          <td class="mdname" nowrap>&nbsp; <em>name</em>, </td>
1965        </tr>
1966        <tr>
1967          <td></td>
1968          <td></td>
1969          <td class="md" nowrap>void *&nbsp;</td>
1970          <td class="mdname" nowrap>&nbsp; <em>value</em></td>
1971        </tr>
1972        <tr>
1973          <td></td>
1974          <td class="md">)&nbsp;</td>
1975          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1976        </tr>
1977
1978      </table>
1979    </td>
1980  </tr>
1981</table>
1982<table cellspacing=5 cellpadding=0 border=0>
1983  <tr>
1984    <td>
1985      &nbsp;
1986    </td>
1987    <td>
1988
1989<p>
1990Set the value of any property in a SAX2 XMLReader.
1991<p>
1992Supported properties in SAX2 for xerces-c are: <br>
1993(See <a href="http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties">http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties</a> for detail description).
1994<p>
1995<br>
1996<a href="http://apache.org/xml/properties/schema/external-schemaLocation">http://apache.org/xml/properties/schema/external-schemaLocation</a> <br>
1997<a href="http://apache.org/xml/properties/schema/external-noNamespaceSchemaLocation.">http://apache.org/xml/properties/schema/external-noNamespaceSchemaLocation.</a>
1998<p>
1999It takes a void pointer as the property value. Application is required to initialize this void pointer to a correct type. See <a href="http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties">http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties</a> to learn exactly what type of property value each property expects for processing. Passing a void pointer that was initialized with a wrong type will lead to unexpected result. If the same property is set more than once, the last one takes effect.<dl compact><dt><b>
2000Parameters: </b><dd>
2001<table border=0 cellspacing=2 cellpadding=0>
2002<tr><td valign=top><em>name</em>&nbsp;</td><td>
2003The unique identifier (URI) of the property being set. </td></tr>
2004<tr><td valign=top><em>value</em>&nbsp;</td><td>
2005The requested value for the property. See <a href="http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties">http://xml.apache.org/xerces-c/program-sax2.html#SAX2Properties</a> to learn exactly what type of property value each property expects for processing. Passing a void pointer that was initialized with a wrong type will lead to unexpected result. </td></tr>
2006</table>
2007</dl><dl compact><dt><b>
2008Exceptions: </b><dd>
2009<table border=0 cellspacing=2 cellpadding=0>
2010<tr><td valign=top><em><a class="el" href="classSAXNotRecognizedException.html">SAXNotRecognizedException</a></em>&nbsp;</td><td>
2011 If the requested property is not known. </td></tr>
2012<tr><td valign=top><em><a class="el" href="classSAXNotSupportedException.html">SAXNotSupportedException</a></em>&nbsp;</td><td>
2013 Property modification is not supported during parse </td></tr>
2014</table>
2015</dl>    </td>
2016  </tr>
2017</table>
2018<a name="z548_2" doxytag="SAX2XMLReader::setValidationConstraintFatal"></a><p>
2019<table width="100%" cellpadding="2" cellspacing="0" border="0">
2020  <tr>
2021    <td class="md">
2022      <table cellpadding="0" cellspacing="0" border="0">
2023        <tr>
2024          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setValidationConstraintFatal </td>
2025          <td class="md" valign="top">(&nbsp;</td>
2026          <td class="md" nowrap valign="top">const bool&nbsp;</td>
2027          <td class="mdname1" valign="top" nowrap>&nbsp; <em>newState</em>          </td>
2028          <td class="md" valign="top">)&nbsp;</td>
2029          <td class="md" nowrap><code> [pure virtual]</code></td>
2030        </tr>
2031
2032      </table>
2033    </td>
2034  </tr>
2035</table>
2036<table cellspacing=5 cellpadding=0 border=0>
2037  <tr>
2038    <td>
2039      &nbsp;
2040    </td>
2041    <td>
2042
2043<p>
2044This method allows users to set the parser's behaviour when it encounters a validtion constraint error.
2045<p>
2046If set to true, and the the parser will treat validation error as fatal and will exit depends on the state of "getExitOnFirstFatalError". If false, then it will report the error and continue processing.
2047<p>
2048Note: setting this true does not mean the validation error will be printed with the word "Fatal Error". It is still printed as "Error", but the parser will exit if "setExitOnFirstFatalError" is set to true.
2049<p>
2050
2051<p>
2052The default value is 'false'.
2053<p>
2054
2055<p>
2056Or you can set the feature "<a href="http://apache.org/xml/features/validation-error-as-fatal">http://apache.org/xml/features/validation-error-as-fatal</a>" which means the same thing.
2057<p>
2058
2059<p>
2060If both the feature above and this function are used, the latter takes effect.<dl compact><dt><b>
2061Parameters: </b><dd>
2062<table border=0 cellspacing=2 cellpadding=0>
2063<tr><td valign=top><em>newState</em>&nbsp;</td><td>
2064If true, the parser will exit if "setExitOnFirstFatalError" is set to true.</td></tr>
2065</table>
2066</dl><dl compact><dt><b>
2067See also: </b><dd>
2068<a class="el" href="classSAX2XMLReader.html#z547_3">getValidationConstraintFatal</a> , <a class="el" href="classSAX2XMLReader.html#z548_1">setExitOnFirstFatalError</a> , <a class="el" href="classSAX2XMLReader.html#z545_10">setFeature</a> </dl>    </td>
2069  </tr>
2070</table>
2071<a name="z548_0" doxytag="SAX2XMLReader::setValidator"></a><p>
2072<table width="100%" cellpadding="2" cellspacing="0" border="0">
2073  <tr>
2074    <td class="md">
2075      <table cellpadding="0" cellspacing="0" border="0">
2076        <tr>
2077          <td class="md" nowrap valign="top"> virtual void SAX2XMLReader::setValidator </td>
2078          <td class="md" valign="top">(&nbsp;</td>
2079          <td class="md" nowrap valign="top"><a class="el" href="classXMLValidator.html">XMLValidator</a> *&nbsp;</td>
2080          <td class="mdname1" valign="top" nowrap>&nbsp; <em>valueToAdopt</em>          </td>
2081          <td class="md" valign="top">)&nbsp;</td>
2082          <td class="md" nowrap><code> [pure virtual]</code></td>
2083        </tr>
2084
2085      </table>
2086    </td>
2087  </tr>
2088</table>
2089<table cellspacing=5 cellpadding=0 border=0>
2090  <tr>
2091    <td>
2092      &nbsp;
2093    </td>
2094    <td>
2095
2096<p>
2097This method is used to set a validator.
2098<p>
2099<b>SAX2XMLReader assumes responsibility for the validator. It will be deleted when the XMLReader is destroyed.</b><dl compact><dt><b>
2100Parameters: </b><dd>
2101<table border=0 cellspacing=2 cellpadding=0>
2102<tr><td valign=top><em>valueToAdopt</em>&nbsp;</td><td>
2103A pointer to the validator that the reader should use. </td></tr>
2104</table>
2105</dl>    </td>
2106  </tr>
2107</table>
2108<hr>The documentation for this class was generated from the following file:<ul>
2109<li><a class="el" href="SAX2XMLReader_8hpp-source.html">SAX2XMLReader.hpp</a></ul>
2110    </FONT></TD></TR></TABLE><BR>
2111</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>
2112              Copyright &copy; 1994-2004 The Apache Software Foundation.
2113              All Rights Reserved.
2114            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.