<!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.5"/>
<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.4</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.5 -->
<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 <a class="el" href="classURLInputSource.html" title="This class is a derivative of the standard InputSource class. ">URLInputSource(systemId)</a>);</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 <a class="el" href="classURLInputSource.html" title="This class is a derivative of the standard InputSource class. ">URLInputSource(systemId)</a>);</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 by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.5
</small></address>
</body>
</html>
distrib
>
Momonga
>
development
>
i686
>
media
>
os
>
by-pkgid
>
18120e83490c95b7ebaf1df70f2d8542
>
files
>
649
