|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.9.1"/> <title>Xerces-C++: Parser Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">Xerces-C++  <span id="projectnumber">3.1.2</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.9.1 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="classParser-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">Parser Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div> </div><!--header--> <div class="contents">
<p>Basic interface for SAX (Simple API for XML) parsers. <a href="classParser.html#details">More...</a></p> <div class="dynheader"> Inheritance diagram for Parser:</div> <div class="dyncontent"> <div class="center"> <img src="classParser.png" usemap="#Parser_map" alt=""/> <map id="Parser_map" name="Parser_map"> <area href="classSAXParser.html" title="This class implements the SAX 'Parser' interface and should be used by applications wishing to parse ..." alt="SAXParser" shape="rect" coords="0,56,76,80"/> </map> </div></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr><td colspan="2"><div class="groupHeader">Constructors and Destructor</div></td></tr> <tr class="memitem:a12234f6cd36b61af4b50c94a179422c1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a12234f6cd36b61af4b50c94a179422c1">Parser</a> ()</td></tr> <tr class="memdesc:a12234f6cd36b61af4b50c94a179422c1"><td class="mdescLeft"> </td><td class="mdescRight">The default constructor. <a href="#a12234f6cd36b61af4b50c94a179422c1">More...</a><br /></td></tr> <tr class="separator:a12234f6cd36b61af4b50c94a179422c1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad576b92b9cc324f6f41b0269a9a1a546"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#ad576b92b9cc324f6f41b0269a9a1a546">~Parser</a> ()</td></tr> <tr class="memdesc:ad576b92b9cc324f6f41b0269a9a1a546"><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <a href="#ad576b92b9cc324f6f41b0269a9a1a546">More...</a><br /></td></tr> <tr class="separator:ad576b92b9cc324f6f41b0269a9a1a546"><td class="memSeparator" colspan="2"> </td></tr> <tr><td colspan="2"><div class="groupHeader">The parser interfaces</div></td></tr> <tr class="memitem:a62435895e0615380f3017090ac232594"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a62435895e0615380f3017090ac232594">setEntityResolver</a> (<a class="el" href="classEntityResolver.html">EntityResolver</a> *const resolver)=0</td></tr> <tr class="memdesc:a62435895e0615380f3017090ac232594"><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a custom entity resolver. <a href="#a62435895e0615380f3017090ac232594">More...</a><br /></td></tr> <tr class="separator:a62435895e0615380f3017090ac232594"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ad97184f9e4397e360903e2fdb72d23bf"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#ad97184f9e4397e360903e2fdb72d23bf">setDTDHandler</a> (<a class="el" href="classDTDHandler.html">DTDHandler</a> *const handler)=0</td></tr> <tr class="memdesc:ad97184f9e4397e360903e2fdb72d23bf"><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a DTD event handler. <a href="#ad97184f9e4397e360903e2fdb72d23bf">More...</a><br /></td></tr> <tr class="separator:ad97184f9e4397e360903e2fdb72d23bf"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a2038c09146fff3b0ec66143630736bdb"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a2038c09146fff3b0ec66143630736bdb">setDocumentHandler</a> (<a class="el" href="classDocumentHandler.html">DocumentHandler</a> *const handler)=0</td></tr> <tr class="memdesc:a2038c09146fff3b0ec66143630736bdb"><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a document event handler. <a href="#a2038c09146fff3b0ec66143630736bdb">More...</a><br /></td></tr> <tr class="separator:a2038c09146fff3b0ec66143630736bdb"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aacd0f62732e363faeb4e5ee5b0a6e12a"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#aacd0f62732e363faeb4e5ee5b0a6e12a">setErrorHandler</a> (<a class="el" href="classErrorHandler.html">ErrorHandler</a> *const handler)=0</td></tr> <tr class="memdesc:aacd0f62732e363faeb4e5ee5b0a6e12a"><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register an error event handler. <a href="#aacd0f62732e363faeb4e5ee5b0a6e12a">More...</a><br /></td></tr> <tr class="separator:aacd0f62732e363faeb4e5ee5b0a6e12a"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a624fc687a49b917c11ef632367568b60"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a624fc687a49b917c11ef632367568b60">parse</a> (const <a class="el" href="classInputSource.html">InputSource</a> &source)=0</td></tr> <tr class="memdesc:a624fc687a49b917c11ef632367568b60"><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document. <a href="#a624fc687a49b917c11ef632367568b60">More...</a><br /></td></tr> <tr class="separator:a624fc687a49b917c11ef632367568b60"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a37d4db3b3e88307b0aad780a685d76fd"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a37d4db3b3e88307b0aad780a685d76fd">parse</a> (const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *const systemId)=0</td></tr> <tr class="memdesc:a37d4db3b3e88307b0aad780a685d76fd"><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document from a system identifier (URI). <a href="#a37d4db3b3e88307b0aad780a685d76fd">More...</a><br /></td></tr> <tr class="separator:a37d4db3b3e88307b0aad780a685d76fd"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a802e068db2ca0b11d8f6365d8a3267c6"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#a802e068db2ca0b11d8f6365d8a3267c6">parse</a> (const char *const systemId)=0</td></tr> <tr class="memdesc:a802e068db2ca0b11d8f6365d8a3267c6"><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document from a system identifier (URI). <a href="#a802e068db2ca0b11d8f6365d8a3267c6">More...</a><br /></td></tr> <tr class="separator:a802e068db2ca0b11d8f6365d8a3267c6"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>Basic interface for SAX (Simple API for XML) parsers. </p> <p>All SAX parsers must implement this basic interface: it allows applications to register handlers for different types of events and to initiate a parse from a URI, or a character stream.</p> <p>All SAX parsers must also implement a zero-argument constructor (though other constructors are also allowed).</p> <p>SAX parsers are reusable but not re-entrant: the application may reuse a parser object (possibly with a different input source) once the first parse has completed successfully, but it may not invoke the <a class="el" href="classParser.html#a624fc687a49b917c11ef632367568b60" title="Parse an XML document. ">parse()</a> methods recursively within a parse.</p> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classEntityResolver.html#a14e534eb2170015056ccd71458e1058c" title="Default Constructor. ">EntityResolver::EntityResolver</a> </dd> <dd> <a class="el" href="classDTDHandler.html#a1d17e15d976164f6d55f542759eea182" title="Default Constructor. ">DTDHandler::DTDHandler</a> </dd> <dd> <a class="el" href="classDocumentHandler.html#ac24bb98e06d7db2b0823816eec2f6c19" title="Default constructor. ">DocumentHandler::DocumentHandler</a> </dd> <dd> <a class="el" href="classErrorHandler.html#a7e5f379bd231442b898cef94556b2107" title="Default constructor. ">ErrorHandler::ErrorHandler</a> </dd> <dd> <a class="el" href="classHandlerBase.html#aa9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd> <dd> <a class="el" href="classInputSource.html#a601a7aa7124e2d8e9664eda9aea6b622" title="Default constructor. ">InputSource::InputSource</a> </dd></dl> </div><h2 class="groupheader">Constructor & Destructor Documentation</h2> <a class="anchor" id="a12234f6cd36b61af4b50c94a179422c1"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Parser::Parser </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc">
<p>The default constructor. </p>
</div> </div> <a class="anchor" id="ad576b92b9cc324f6f41b0269a9a1a546"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual Parser::~Parser </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>The destructor. </p>
</div> </div> <h2 class="groupheader">Member Function Documentation</h2> <a class="anchor" id="a624fc687a49b917c11ef632367568b60"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::parse </td> <td>(</td> <td class="paramtype">const <a class="el" href="classInputSource.html">InputSource</a> & </td> <td class="paramname"><em>source</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Parse an XML document. </p> <p>The 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).</p> <p>Applications may not invoke this method while a parse is in progress (they should create a new <a class="el" href="classParser.html" title="Basic interface for SAX (Simple API for XML) parsers. ">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" title="Basic interface for SAX (Simple API for XML) parsers. ">Parser</a> object, possibly with a different input source.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">source</td><td>The input source for the top-level of the XML document. </td></tr> </table> </dd> </dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname"><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning. ">SAXException</a></td><td>Any SAX exception, possibly wrapping another exception. </td></tr> <tr><td class="paramname"><a class="el" href="classXMLException.html">XMLException</a></td><td>An exception from the parser or client handler code. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classInputSource.html#a601a7aa7124e2d8e9664eda9aea6b622" title="Default constructor. ">InputSource::InputSource</a> </dd> <dd> <a class="el" href="classParser.html#a62435895e0615380f3017090ac232594" title="Allow an application to register a custom entity resolver. ">setEntityResolver</a> </dd> <dd> <a class="el" href="classParser.html#ad97184f9e4397e360903e2fdb72d23bf" title="Allow an application to register a DTD event handler. ">setDTDHandler</a> </dd> <dd> <a class="el" href="classParser.html#a2038c09146fff3b0ec66143630736bdb" title="Allow an application to register a document event handler. ">setDocumentHandler</a> </dd> <dd> <a class="el" href="classParser.html#aacd0f62732e363faeb4e5ee5b0a6e12a" title="Allow an application to register an error event handler. ">setErrorHandler</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#ad684882ed98a172675553abe68109666">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="a37d4db3b3e88307b0aad780a685d76fd"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::parse </td> <td>(</td> <td class="paramtype">const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *const </td> <td class="paramname"><em>systemId</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Parse an XML document from a system identifier (URI). </p> <p>This method is a shortcut for the common case of reading a document from a system identifier. It is the exact equivalent of the following:</p> <p>parse(new URLInputSource(systemId));</p> <p>If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">systemId</td><td>The system identifier (URI). </td></tr> </table> </dd> </dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname"><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning. ">SAXException</a></td><td>Any SAX exception, possibly wrapping another exception. </td></tr> <tr><td class="paramname"><a class="el" href="classXMLException.html">XMLException</a></td><td>An exception from the parser or client handler code. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classParser.html#a624fc687a49b917c11ef632367568b60" title="Parse an XML document. ">parse(const InputSource&)</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#a4a5146bda42a0ba972a6fbd77146e828">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="a802e068db2ca0b11d8f6365d8a3267c6"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::parse </td> <td>(</td> <td class="paramtype">const char *const </td> <td class="paramname"><em>systemId</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Parse an XML document from a system identifier (URI). </p> <p>This method is a shortcut for the common case of reading a document from a system identifier. It is the exact equivalent of the following:</p> <p>parse(new URLInputSource(systemId));</p> <p>If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">systemId</td><td>The system identifier (URI). </td></tr> </table> </dd> </dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname"><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning. ">SAXException</a></td><td>Any SAX exception, possibly wrapping another exception. </td></tr> <tr><td class="paramname"><a class="el" href="classXMLException.html">XMLException</a></td><td>An exception from the parser or client handler code. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classParser.html#a624fc687a49b917c11ef632367568b60" title="Parse an XML document. ">parse(const InputSource&)</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#a6e928e936c15ef184fd286380e9f8c14">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="a2038c09146fff3b0ec66143630736bdb"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::setDocumentHandler </td> <td>(</td> <td class="paramtype"><a class="el" href="classDocumentHandler.html">DocumentHandler</a> *const </td> <td class="paramname"><em>handler</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Allow an application to register a document event handler. </p> <p>If 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" title="Default base class for handlers. ">HandlerBase</a>).</p> <p>Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">handler</td><td>The document handler. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDocumentHandler.html#ac24bb98e06d7db2b0823816eec2f6c19" title="Default constructor. ">DocumentHandler::DocumentHandler</a> </dd> <dd> <a class="el" href="classHandlerBase.html#aa9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#af8593f6ca5ebb7c96d63eaea6935b1a9">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="ad97184f9e4397e360903e2fdb72d23bf"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::setDTDHandler </td> <td>(</td> <td class="paramtype"><a class="el" href="classDTDHandler.html">DTDHandler</a> *const </td> <td class="paramname"><em>handler</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Allow an application to register a DTD event handler. </p> <p>If 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" title="Default base class for handlers. ">HandlerBase</a>).</p> <p>Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">handler</td><td>The DTD handler. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDTDHandler.html#a1d17e15d976164f6d55f542759eea182" title="Default Constructor. ">DTDHandler::DTDHandler</a> </dd> <dd> <a class="el" href="classHandlerBase.html#aa9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#a718d0f982508496ac008a1b4f20eba06">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="a62435895e0615380f3017090ac232594"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::setEntityResolver </td> <td>(</td> <td class="paramtype"><a class="el" href="classEntityResolver.html">EntityResolver</a> *const </td> <td class="paramname"><em>resolver</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Allow an application to register a custom entity resolver. </p> <p>If 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="classHandlerBase.html" title="Default base class for handlers. ">HandlerBase</a>).</p> <p>Applications 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.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">resolver</td><td>The object for resolving entities. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classEntityResolver.html#a14e534eb2170015056ccd71458e1058c" title="Default Constructor. ">EntityResolver::EntityResolver</a> </dd> <dd> <a class="el" href="classHandlerBase.html#aa9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#a55ca3032890cc8893cfcfc15753db57b">SAXParser</a>.</p>
</div> </div> <a class="anchor" id="aacd0f62732e363faeb4e5ee5b0a6e12a"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual void Parser::setErrorHandler </td> <td>(</td> <td class="paramtype"><a class="el" href="classErrorHandler.html">ErrorHandler</a> *const </td> <td class="paramname"><em>handler</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc">
<p>Allow an application to register an error event handler. </p> <p>If 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" title="Encapsulate a general SAX error or warning. ">SAXException</a> (this is the default behaviour implemented by <a class="el" href="classHandlerBase.html" title="Default base class for handlers. ">HandlerBase</a>).</p> <p>Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">handler</td><td>The error handler. </td></tr> </table> </dd> </dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="classErrorHandler.html#a7e5f379bd231442b898cef94556b2107" title="Default constructor. ">ErrorHandler::ErrorHandler</a> </dd> <dd> <a class="el" href="classSAXException.html#ae1c8ab9b99e3c43572c1567e72c652e4" title="Default constructor. ">SAXException::SAXException</a> </dd> <dd> <a class="el" href="classHandlerBase.html#aa9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl>
<p>Implemented in <a class="el" href="classSAXParser.html#a4f473c91401970cfaed6147caaa41cbd">SAXParser</a>.</p>
</div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li><a class="el" href="Parser_8hpp_source.html">Parser.hpp</a></li> </ul> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Wed Mar 18 2015 10:43:38 for Xerces-C++ by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.9.1 </small></address> </body> </html>
|