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

Revision 358, 54.0 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>HandlerBase 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>HandlerBase  Class Reference</h1>Default base class for handlers.
45<a href="#_details">More...</a>
46<p>
47Inheritance diagram for HandlerBase:<p><center><img src="classHandlerBase__inherit__graph.gif" border="0" usemap="#HandlerBase__inherit__map" alt="Inheritance graph"></center>
48<map name="HandlerBase__inherit__map">
49<area href="classEntityResolver.html" shape="rect" coords="7,36,103,17" alt="">
50<area href="classDTDHandler.html" shape="rect" coords="127,36,212,17" alt="">
51<area href="classDocumentHandler.html" shape="rect" coords="236,36,353,17" alt="">
52<area href="classErrorHandler.html" shape="rect" coords="377,36,463,17" alt="">
53</map>
54<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center>Collaboration diagram for HandlerBase:<p><center><img src="classHandlerBase__coll__graph.gif" border="0" usemap="#HandlerBase__coll__map" alt="Collaboration graph"></center>
55<map name="HandlerBase__coll__map">
56<area href="classEntityResolver.html" shape="rect" coords="7,36,103,17" alt="">
57<area href="classDTDHandler.html" shape="rect" coords="127,36,212,17" alt="">
58<area href="classDocumentHandler.html" shape="rect" coords="236,36,353,17" alt="">
59<area href="classErrorHandler.html" shape="rect" coords="377,36,463,17" alt="">
60</map>
61<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classHandlerBase-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
62<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
63<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#a0">HandlerBase</a> ()</td></tr>
64<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#a1">~HandlerBase</a> ()</td></tr>
65<tr><td colspan="2"><div class="groupHeader">Default handlers for the DocumentHandler interface</div></td></tr>
66<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_0">characters</a> (const XMLCh *const chars, const unsigned int length)</td></tr>
67<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of character data inside an element.</em> <a href="#z428_0">More...</a><em></em></font><br><br></td></tr>
68<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_1">endDocument</a> ()</td></tr>
69<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of the end of the document.</em> <a href="#z428_1">More...</a><em></em></font><br><br></td></tr>
70<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_2">endElement</a> (const XMLCh *const name)</td></tr>
71<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of the end of an element.</em> <a href="#z428_2">More...</a><em></em></font><br><br></td></tr>
72<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_3">ignorableWhitespace</a> (const XMLCh *const chars, const unsigned int length)</td></tr>
73<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of ignorable whitespace in element content.</em> <a href="#z428_3">More...</a><em></em></font><br><br></td></tr>
74<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_4">processingInstruction</a> (const XMLCh *const target, const XMLCh *const data)</td></tr>
75<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of a processing instruction.</em> <a href="#z428_4">More...</a><em></em></font><br><br></td></tr>
76<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z428_5">resetDocument</a> ()</td></tr>
77<tr><td>&nbsp;</td><td><font size=-1><em>Reset the Docuemnt object on its reuse.</em> <a href="#z428_5">More...</a><em></em></font><br><br></td></tr>
78<tr><td colspan="2"><div class="groupHeader">Default implementation of DocumentHandler interface</div></td></tr>
79<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z429_0">setDocumentLocator</a> (const <a class="el" href="classLocator.html">Locator</a> *const locator)</td></tr>
80<tr><td>&nbsp;</td><td><font size=-1><em>Receive a <a class="el" href="classLocator.html">Locator</a> object for document events.</em> <a href="#z429_0">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="classHandlerBase.html#z429_1">startDocument</a> ()</td></tr>
82<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of the beginning of the document.</em> <a href="#z429_1">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="classHandlerBase.html#z429_2">startElement</a> (const XMLCh *const name, <a class="el" href="classAttributeList.html">AttributeList</a> &amp;attributes)</td></tr>
84<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of the start of an element.</em> <a href="#z429_2">More...</a><em></em></font><br><br></td></tr>
85<tr><td colspan="2"><div class="groupHeader">Default implementation of the EntityResolver interface.</div></td></tr>
86<tr><td nowrap align=right valign=top>virtual <a class="el" href="classInputSource.html">InputSource</a> *&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z430_0">resolveEntity</a> (const XMLCh *const publicId, const XMLCh *const systemId)</td></tr>
87<tr><td>&nbsp;</td><td><font size=-1><em>Resolve an external entity.</em> <a href="#z430_0">More...</a><em></em></font><br><br></td></tr>
88<tr><td colspan="2"><div class="groupHeader">Default implementation of the ErrorHandler interface</div></td></tr>
89<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z431_0">error</a> (const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;exc)</td></tr>
90<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of a recoverable parser error.</em> <a href="#z431_0">More...</a><em></em></font><br><br></td></tr>
91<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z431_1">fatalError</a> (const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;exc)</td></tr>
92<tr><td>&nbsp;</td><td><font size=-1><em>Report a fatal XML parsing error.</em> <a href="#z431_1">More...</a><em></em></font><br><br></td></tr>
93<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z431_2">warning</a> (const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;exc)</td></tr>
94<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of a parser warning.</em> <a href="#z431_2">More...</a><em></em></font><br><br></td></tr>
95<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z431_3">resetErrors</a> ()</td></tr>
96<tr><td>&nbsp;</td><td><font size=-1><em>Reset the Error handler object on its reuse.</em> <a href="#z431_3">More...</a><em></em></font><br><br></td></tr>
97<tr><td colspan="2"><div class="groupHeader">Default implementation of DTDHandler interface.</div></td></tr>
98<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z432_0">notationDecl</a> (const XMLCh *const name, const XMLCh *const publicId, const XMLCh *const systemId)</td></tr>
99<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of a notation declaration.</em> <a href="#z432_0">More...</a><em></em></font><br><br></td></tr>
100<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z432_1">resetDocType</a> ()</td></tr>
101<tr><td>&nbsp;</td><td><font size=-1><em>Reset the DTD object on its reuse.</em> <a href="#z432_1">More...</a><em></em></font><br><br></td></tr>
102<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classHandlerBase.html#z432_2">unparsedEntityDecl</a> (const XMLCh *const name, const XMLCh *const publicId, const XMLCh *const systemId, const XMLCh *const notationName)</td></tr>
103<tr><td>&nbsp;</td><td><font size=-1><em>Receive notification of an unparsed entity declaration.</em> <a href="#z432_2">More...</a><em></em></font><br><br></td></tr>
104</table>
105<hr><a name="_details"></a><h2>Detailed Description</h2>
106Default base class for handlers.
107<p>
108
109<p>
110This class implements the default behaviour for four SAX interfaces: <a class="el" href="classEntityResolver.html">EntityResolver</a>, <a class="el" href="classDTDHandler.html">DTDHandler</a>, <a class="el" href="classDocumentHandler.html">DocumentHandler</a>, and <a class="el" href="classErrorHandler.html">ErrorHandler</a>.
111<p>
112
113<p>
114Application writers can extend this class when they need to implement only part of an interface; parser writers can instantiate this class to provide default handlers when the application has not supplied its own.
115<p>
116
117<p>
118Note that the use of this class is optional.
119<p>
120<dl compact><dt><b>
121See also: </b><dd>
122<a class="el" href="classEntityResolver.html#z424_0">EntityResolver::EntityResolver</a> , <a class="el" href="classDTDHandler.html#z422_0">DTDHandler::DTDHandler</a> , <a class="el" href="classDocumentHandler.html#z420_0">DocumentHandler::DocumentHandler</a> , <a class="el" href="classErrorHandler.html#z426_0">ErrorHandler::ErrorHandler</a> </dl>
123<p>
124<hr><h2>Constructor &amp; Destructor Documentation</h2>
125<a name="a0" doxytag="HandlerBase::HandlerBase"></a><p>
126<table width="100%" cellpadding="2" cellspacing="0" border="0">
127  <tr>
128    <td class="md">
129      <table cellpadding="0" cellspacing="0" border="0">
130        <tr>
131          <td class="md" nowrap valign="top"> HandlerBase::HandlerBase </td>
132          <td class="md" valign="top">(&nbsp;</td>
133          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
134          <td class="md" valign="top">)&nbsp;</td>
135          <td class="md" nowrap></td>
136        </tr>
137
138      </table>
139    </td>
140  </tr>
141</table>
142<table cellspacing=5 cellpadding=0 border=0>
143  <tr>
144    <td>
145      &nbsp;
146    </td>
147    <td>
148
149<p>
150    </td>
151  </tr>
152</table>
153<a name="a1" doxytag="HandlerBase::~HandlerBase"></a><p>
154<table width="100%" cellpadding="2" cellspacing="0" border="0">
155  <tr>
156    <td class="md">
157      <table cellpadding="0" cellspacing="0" border="0">
158        <tr>
159          <td class="md" nowrap valign="top"> virtual HandlerBase::~HandlerBase </td>
160          <td class="md" valign="top">(&nbsp;</td>
161          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
162          <td class="md" valign="top">)&nbsp;</td>
163          <td class="md" nowrap><code> [virtual]</code></td>
164        </tr>
165
166      </table>
167    </td>
168  </tr>
169</table>
170<table cellspacing=5 cellpadding=0 border=0>
171  <tr>
172    <td>
173      &nbsp;
174    </td>
175    <td>
176
177<p>
178    </td>
179  </tr>
180</table>
181<hr><h2>Member Function Documentation</h2>
182<a name="z428_0" doxytag="HandlerBase::characters"></a><p>
183<table width="100%" cellpadding="2" cellspacing="0" border="0">
184  <tr>
185    <td class="md">
186      <table cellpadding="0" cellspacing="0" border="0">
187        <tr>
188          <td class="md" nowrap valign="top"> void HandlerBase::characters </td>
189          <td class="md" valign="top">(&nbsp;</td>
190          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
191          <td class="mdname" nowrap>&nbsp; <em>chars</em>, </td>
192        </tr>
193        <tr>
194          <td></td>
195          <td></td>
196          <td class="md" nowrap>const unsigned int&nbsp;</td>
197          <td class="mdname" nowrap>&nbsp; <em>length</em></td>
198        </tr>
199        <tr>
200          <td></td>
201          <td class="md">)&nbsp;</td>
202          <td class="md" colspan="2"><code> [virtual]</code></td>
203        </tr>
204
205      </table>
206    </td>
207  </tr>
208</table>
209<table cellspacing=5 cellpadding=0 border=0>
210  <tr>
211    <td>
212      &nbsp;
213    </td>
214    <td>
215
216<p>
217Receive notification of character data inside an element.
218<p>
219
220<p>
221By default, do nothing. Application writers may override this method to take specific actions for each chunk of character data (such as adding the data to a node or buffer, or printing it to a file).<dl compact><dt><b>
222Parameters: </b><dd>
223<table border=0 cellspacing=2 cellpadding=0>
224<tr><td valign=top><em>chars</em>&nbsp;</td><td>
225The characters. </td></tr>
226<tr><td valign=top><em>length</em>&nbsp;</td><td>
227The number of characters to use from the character array. </td></tr>
228</table>
229</dl><dl compact><dt><b>
230Exceptions: </b><dd>
231<table border=0 cellspacing=2 cellpadding=0>
232<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
233 Any SAX exception, possibly wrapping another exception. </td></tr>
234</table>
235</dl><dl compact><dt><b>
236See also: </b><dd>
237<a class="el" href="classDocumentHandler.html#z421_0">DocumentHandler::characters</a> </dl>
238<p>
239Implements <a class="el" href="classDocumentHandler.html#z421_0">DocumentHandler</a>.    </td>
240  </tr>
241</table>
242<a name="z428_1" doxytag="HandlerBase::endDocument"></a><p>
243<table width="100%" cellpadding="2" cellspacing="0" border="0">
244  <tr>
245    <td class="md">
246      <table cellpadding="0" cellspacing="0" border="0">
247        <tr>
248          <td class="md" nowrap valign="top"> void HandlerBase::endDocument </td>
249          <td class="md" valign="top">(&nbsp;</td>
250          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
251          <td class="md" valign="top">)&nbsp;</td>
252          <td class="md" nowrap><code> [virtual]</code></td>
253        </tr>
254
255      </table>
256    </td>
257  </tr>
258</table>
259<table cellspacing=5 cellpadding=0 border=0>
260  <tr>
261    <td>
262      &nbsp;
263    </td>
264    <td>
265
266<p>
267Receive notification of the end of the document.
268<p>
269
270<p>
271By default, do nothing. Application writers may override this method in a subclass to take specific actions at the beginning of a document (such as finalising a tree or closing an output file).<dl compact><dt><b>
272Exceptions: </b><dd>
273<table border=0 cellspacing=2 cellpadding=0>
274<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
275 Any SAX exception, possibly wrapping another exception. </td></tr>
276</table>
277</dl><dl compact><dt><b>
278See also: </b><dd>
279<a class="el" href="classDocumentHandler.html#z421_1">DocumentHandler::endDocument</a> </dl>
280<p>
281Implements <a class="el" href="classDocumentHandler.html#z421_1">DocumentHandler</a>.    </td>
282  </tr>
283</table>
284<a name="z428_2" doxytag="HandlerBase::endElement"></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"> void HandlerBase::endElement </td>
291          <td class="md" valign="top">(&nbsp;</td>
292          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
293          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
294          <td class="md" valign="top">)&nbsp;</td>
295          <td class="md" nowrap><code> [virtual]</code></td>
296        </tr>
297
298      </table>
299    </td>
300  </tr>
301</table>
302<table cellspacing=5 cellpadding=0 border=0>
303  <tr>
304    <td>
305      &nbsp;
306    </td>
307    <td>
308
309<p>
310Receive notification of the end of an element.
311<p>
312
313<p>
314By default, do nothing. Application writers may override this method in a subclass to take specific actions at the end of each element (such as finalising a tree node or writing output to a file).<dl compact><dt><b>
315Parameters: </b><dd>
316<table border=0 cellspacing=2 cellpadding=0>
317<tr><td valign=top><em>name</em>&nbsp;</td><td>
318The element type name. </td></tr>
319</table>
320</dl><dl compact><dt><b>
321Exceptions: </b><dd>
322<table border=0 cellspacing=2 cellpadding=0>
323<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
324 Any SAX exception, possibly wrapping another exception. </td></tr>
325</table>
326</dl><dl compact><dt><b>
327See also: </b><dd>
328<a class="el" href="classDocumentHandler.html#z421_2">DocumentHandler::endElement</a> </dl>
329<p>
330Implements <a class="el" href="classDocumentHandler.html#z421_2">DocumentHandler</a>.    </td>
331  </tr>
332</table>
333<a name="z431_0" doxytag="HandlerBase::error"></a><p>
334<table width="100%" cellpadding="2" cellspacing="0" border="0">
335  <tr>
336    <td class="md">
337      <table cellpadding="0" cellspacing="0" border="0">
338        <tr>
339          <td class="md" nowrap valign="top"> void HandlerBase::error </td>
340          <td class="md" valign="top">(&nbsp;</td>
341          <td class="md" nowrap valign="top">const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;&nbsp;</td>
342          <td class="mdname1" valign="top" nowrap>&nbsp; <em>exc</em>          </td>
343          <td class="md" valign="top">)&nbsp;</td>
344          <td class="md" nowrap><code> [virtual]</code></td>
345        </tr>
346
347      </table>
348    </td>
349  </tr>
350</table>
351<table cellspacing=5 cellpadding=0 border=0>
352  <tr>
353    <td>
354      &nbsp;
355    </td>
356    <td>
357
358<p>
359Receive notification of a recoverable parser error.
360<p>
361
362<p>
363The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each error, such as inserting the message in a log file or printing it to the console.<dl compact><dt><b>
364Parameters: </b><dd>
365<table border=0 cellspacing=2 cellpadding=0>
366<tr><td valign=top><em>exc</em>&nbsp;</td><td>
367The warning information encoded as an exception. </td></tr>
368</table>
369</dl><dl compact><dt><b>
370Exceptions: </b><dd>
371<table border=0 cellspacing=2 cellpadding=0>
372<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
373 Any SAX exception, possibly wrapping another exception. </td></tr>
374</table>
375</dl><dl compact><dt><b>
376See also: </b><dd>
377<a class="el" href="classErrorHandler.html#z427_0">ErrorHandler::warning</a> , <a class="el" href="classSAXParseException.html#z445_0">SAXParseException::SAXParseException</a> </dl>
378<p>
379Implements <a class="el" href="classErrorHandler.html#z427_1">ErrorHandler</a>.    </td>
380  </tr>
381</table>
382<a name="z431_1" doxytag="HandlerBase::fatalError"></a><p>
383<table width="100%" cellpadding="2" cellspacing="0" border="0">
384  <tr>
385    <td class="md">
386      <table cellpadding="0" cellspacing="0" border="0">
387        <tr>
388          <td class="md" nowrap valign="top"> void HandlerBase::fatalError </td>
389          <td class="md" valign="top">(&nbsp;</td>
390          <td class="md" nowrap valign="top">const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;&nbsp;</td>
391          <td class="mdname1" valign="top" nowrap>&nbsp; <em>exc</em>          </td>
392          <td class="md" valign="top">)&nbsp;</td>
393          <td class="md" nowrap><code> [virtual]</code></td>
394        </tr>
395
396      </table>
397    </td>
398  </tr>
399</table>
400<table cellspacing=5 cellpadding=0 border=0>
401  <tr>
402    <td>
403      &nbsp;
404    </td>
405    <td>
406
407<p>
408Report a fatal XML parsing error.
409<p>
410
411<p>
412The default implementation throws a <a class="el" href="classSAXParseException.html">SAXParseException</a>. Application writers may override this method in a subclass if they need to take specific actions for each fatal error (such as collecting all of the errors into a single report): in any case, the application must stop all regular processing when this method is invoked, since the document is no longer reliable, and the parser may no longer report parsing events.<dl compact><dt><b>
413Parameters: </b><dd>
414<table border=0 cellspacing=2 cellpadding=0>
415<tr><td valign=top><em>exc</em>&nbsp;</td><td>
416The error information encoded as an exception. </td></tr>
417</table>
418</dl><dl compact><dt><b>
419Exceptions: </b><dd>
420<table border=0 cellspacing=2 cellpadding=0>
421<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
422 Any SAX exception, possibly wrapping another exception. </td></tr>
423</table>
424</dl><dl compact><dt><b>
425See also: </b><dd>
426<a class="el" href="classErrorHandler.html#z427_2">ErrorHandler::fatalError</a> , <a class="el" href="classSAXParseException.html#z445_0">SAXParseException::SAXParseException</a> </dl>
427<p>
428Implements <a class="el" href="classErrorHandler.html#z427_2">ErrorHandler</a>.    </td>
429  </tr>
430</table>
431<a name="z428_3" doxytag="HandlerBase::ignorableWhitespace"></a><p>
432<table width="100%" cellpadding="2" cellspacing="0" border="0">
433  <tr>
434    <td class="md">
435      <table cellpadding="0" cellspacing="0" border="0">
436        <tr>
437          <td class="md" nowrap valign="top"> void HandlerBase::ignorableWhitespace </td>
438          <td class="md" valign="top">(&nbsp;</td>
439          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
440          <td class="mdname" nowrap>&nbsp; <em>chars</em>, </td>
441        </tr>
442        <tr>
443          <td></td>
444          <td></td>
445          <td class="md" nowrap>const unsigned int&nbsp;</td>
446          <td class="mdname" nowrap>&nbsp; <em>length</em></td>
447        </tr>
448        <tr>
449          <td></td>
450          <td class="md">)&nbsp;</td>
451          <td class="md" colspan="2"><code> [virtual]</code></td>
452        </tr>
453
454      </table>
455    </td>
456  </tr>
457</table>
458<table cellspacing=5 cellpadding=0 border=0>
459  <tr>
460    <td>
461      &nbsp;
462    </td>
463    <td>
464
465<p>
466Receive notification of ignorable whitespace in element content.
467<p>
468
469<p>
470By default, do nothing. Application writers may override this method to take specific actions for each chunk of ignorable whitespace (such as adding data to a node or buffer, or printing it to a file).<dl compact><dt><b>
471Parameters: </b><dd>
472<table border=0 cellspacing=2 cellpadding=0>
473<tr><td valign=top><em>chars</em>&nbsp;</td><td>
474The whitespace characters. </td></tr>
475<tr><td valign=top><em>length</em>&nbsp;</td><td>
476The number of characters to use from the character array. </td></tr>
477</table>
478</dl><dl compact><dt><b>
479Exceptions: </b><dd>
480<table border=0 cellspacing=2 cellpadding=0>
481<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
482 Any SAX exception, possibly wrapping another exception. </td></tr>
483</table>
484</dl><dl compact><dt><b>
485See also: </b><dd>
486<a class="el" href="classDocumentHandler.html#z421_3">DocumentHandler::ignorableWhitespace</a> </dl>
487<p>
488Implements <a class="el" href="classDocumentHandler.html#z421_3">DocumentHandler</a>.    </td>
489  </tr>
490</table>
491<a name="z432_0" doxytag="HandlerBase::notationDecl"></a><p>
492<table width="100%" cellpadding="2" cellspacing="0" border="0">
493  <tr>
494    <td class="md">
495      <table cellpadding="0" cellspacing="0" border="0">
496        <tr>
497          <td class="md" nowrap valign="top"> void HandlerBase::notationDecl </td>
498          <td class="md" valign="top">(&nbsp;</td>
499          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
500          <td class="mdname" nowrap>&nbsp; <em>name</em>, </td>
501        </tr>
502        <tr>
503          <td></td>
504          <td></td>
505          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
506          <td class="mdname" nowrap>&nbsp; <em>publicId</em>, </td>
507        </tr>
508        <tr>
509          <td></td>
510          <td></td>
511          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
512          <td class="mdname" nowrap>&nbsp; <em>systemId</em></td>
513        </tr>
514        <tr>
515          <td></td>
516          <td class="md">)&nbsp;</td>
517          <td class="md" colspan="2"><code> [virtual]</code></td>
518        </tr>
519
520      </table>
521    </td>
522  </tr>
523</table>
524<table cellspacing=5 cellpadding=0 border=0>
525  <tr>
526    <td>
527      &nbsp;
528    </td>
529    <td>
530
531<p>
532Receive notification of a notation declaration.
533<p>
534
535<p>
536By default, do nothing. Application writers may override this method in a subclass if they wish to keep track of the notations declared in a document.<dl compact><dt><b>
537Parameters: </b><dd>
538<table border=0 cellspacing=2 cellpadding=0>
539<tr><td valign=top><em>name</em>&nbsp;</td><td>
540The notation name. </td></tr>
541<tr><td valign=top><em>publicId</em>&nbsp;</td><td>
542The notation public identifier, or null if not available. </td></tr>
543<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
544The notation system identifier. </td></tr>
545</table>
546</dl><dl compact><dt><b>
547See also: </b><dd>
548<a class="el" href="classDTDHandler.html#z423_0">DTDHandler::notationDecl</a> </dl>
549<p>
550Implements <a class="el" href="classDTDHandler.html#z423_0">DTDHandler</a>.    </td>
551  </tr>
552</table>
553<a name="z428_4" doxytag="HandlerBase::processingInstruction"></a><p>
554<table width="100%" cellpadding="2" cellspacing="0" border="0">
555  <tr>
556    <td class="md">
557      <table cellpadding="0" cellspacing="0" border="0">
558        <tr>
559          <td class="md" nowrap valign="top"> void HandlerBase::processingInstruction </td>
560          <td class="md" valign="top">(&nbsp;</td>
561          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
562          <td class="mdname" nowrap>&nbsp; <em>target</em>, </td>
563        </tr>
564        <tr>
565          <td></td>
566          <td></td>
567          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
568          <td class="mdname" nowrap>&nbsp; <em>data</em></td>
569        </tr>
570        <tr>
571          <td></td>
572          <td class="md">)&nbsp;</td>
573          <td class="md" colspan="2"><code> [virtual]</code></td>
574        </tr>
575
576      </table>
577    </td>
578  </tr>
579</table>
580<table cellspacing=5 cellpadding=0 border=0>
581  <tr>
582    <td>
583      &nbsp;
584    </td>
585    <td>
586
587<p>
588Receive notification of a processing instruction.
589<p>
590
591<p>
592By default, do nothing. Application writers may override this method in a subclass to take specific actions for each processing instruction, such as setting status variables or invoking other methods.<dl compact><dt><b>
593Parameters: </b><dd>
594<table border=0 cellspacing=2 cellpadding=0>
595<tr><td valign=top><em>target</em>&nbsp;</td><td>
596The processing instruction target. </td></tr>
597<tr><td valign=top><em>data</em>&nbsp;</td><td>
598The processing instruction data, or null if none is supplied. </td></tr>
599</table>
600</dl><dl compact><dt><b>
601Exceptions: </b><dd>
602<table border=0 cellspacing=2 cellpadding=0>
603<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
604 Any SAX exception, possibly wrapping another exception. </td></tr>
605</table>
606</dl><dl compact><dt><b>
607See also: </b><dd>
608<a class="el" href="classDocumentHandler.html#z421_4">DocumentHandler::processingInstruction</a> </dl>
609<p>
610Implements <a class="el" href="classDocumentHandler.html#z421_4">DocumentHandler</a>.    </td>
611  </tr>
612</table>
613<a name="z432_1" doxytag="HandlerBase::resetDocType"></a><p>
614<table width="100%" cellpadding="2" cellspacing="0" border="0">
615  <tr>
616    <td class="md">
617      <table cellpadding="0" cellspacing="0" border="0">
618        <tr>
619          <td class="md" nowrap valign="top"> void HandlerBase::resetDocType </td>
620          <td class="md" valign="top">(&nbsp;</td>
621          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
622          <td class="md" valign="top">)&nbsp;</td>
623          <td class="md" nowrap><code> [virtual]</code></td>
624        </tr>
625
626      </table>
627    </td>
628  </tr>
629</table>
630<table cellspacing=5 cellpadding=0 border=0>
631  <tr>
632    <td>
633      &nbsp;
634    </td>
635    <td>
636
637<p>
638Reset the DTD object on its reuse.
639<p>
640<dl compact><dt><b>
641See also: </b><dd>
642<a class="el" href="classDTDHandler.html#z423_2">DTDHandler::resetDocType</a> </dl>
643<p>
644Implements <a class="el" href="classDTDHandler.html#z423_2">DTDHandler</a>.    </td>
645  </tr>
646</table>
647<a name="z428_5" doxytag="HandlerBase::resetDocument"></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"> void HandlerBase::resetDocument </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> [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>
672Reset the Docuemnt object on its reuse.
673<p>
674<dl compact><dt><b>
675See also: </b><dd>
676<a class="el" href="classDocumentHandler.html#z421_5">DocumentHandler::resetDocument</a> </dl>
677<p>
678Implements <a class="el" href="classDocumentHandler.html#z421_5">DocumentHandler</a>.    </td>
679  </tr>
680</table>
681<a name="z431_3" doxytag="HandlerBase::resetErrors"></a><p>
682<table width="100%" cellpadding="2" cellspacing="0" border="0">
683  <tr>
684    <td class="md">
685      <table cellpadding="0" cellspacing="0" border="0">
686        <tr>
687          <td class="md" nowrap valign="top"> void HandlerBase::resetErrors </td>
688          <td class="md" valign="top">(&nbsp;</td>
689          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
690          <td class="md" valign="top">)&nbsp;</td>
691          <td class="md" nowrap><code> [virtual]</code></td>
692        </tr>
693
694      </table>
695    </td>
696  </tr>
697</table>
698<table cellspacing=5 cellpadding=0 border=0>
699  <tr>
700    <td>
701      &nbsp;
702    </td>
703    <td>
704
705<p>
706Reset the Error handler object on its reuse.
707<p>
708<dl compact><dt><b>
709See also: </b><dd>
710<a class="el" href="classErrorHandler.html#z427_3">ErrorHandler::resetErrors</a> </dl>
711<p>
712Implements <a class="el" href="classErrorHandler.html#z427_3">ErrorHandler</a>.    </td>
713  </tr>
714</table>
715<a name="z430_0" doxytag="HandlerBase::resolveEntity"></a><p>
716<table width="100%" cellpadding="2" cellspacing="0" border="0">
717  <tr>
718    <td class="md">
719      <table cellpadding="0" cellspacing="0" border="0">
720        <tr>
721          <td class="md" nowrap valign="top"> <a class="el" href="classInputSource.html">InputSource</a> * HandlerBase::resolveEntity </td>
722          <td class="md" valign="top">(&nbsp;</td>
723          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
724          <td class="mdname" nowrap>&nbsp; <em>publicId</em>, </td>
725        </tr>
726        <tr>
727          <td></td>
728          <td></td>
729          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
730          <td class="mdname" nowrap>&nbsp; <em>systemId</em></td>
731        </tr>
732        <tr>
733          <td></td>
734          <td class="md">)&nbsp;</td>
735          <td class="md" colspan="2"><code> [virtual]</code></td>
736        </tr>
737
738      </table>
739    </td>
740  </tr>
741</table>
742<table cellspacing=5 cellpadding=0 border=0>
743  <tr>
744    <td>
745      &nbsp;
746    </td>
747    <td>
748
749<p>
750Resolve an external entity.
751<p>
752
753<p>
754Always return null, so that the parser will use the system identifier provided in the XML document. This method implements the SAX default behaviour: application writers can override it in a subclass to do special translations such as catalog lookups or URI redirection.<dl compact><dt><b>
755Parameters: </b><dd>
756<table border=0 cellspacing=2 cellpadding=0>
757<tr><td valign=top><em>publicId</em>&nbsp;</td><td>
758The public identifer, or null if none is available. </td></tr>
759<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
760The system identifier provided in the XML document. </td></tr>
761</table>
762</dl><dl compact><dt><b>
763Returns: </b><dd>
764The new input source, or null to require the default behaviour. The returned <a class="el" href="classInputSource.html">InputSource</a> is owned by the parser which is responsible to clean up the memory. </dl><dl compact><dt><b>
765Exceptions: </b><dd>
766<table border=0 cellspacing=2 cellpadding=0>
767<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
768 Any SAX exception, possibly wrapping another exception. </td></tr>
769</table>
770</dl><dl compact><dt><b>
771See also: </b><dd>
772<a class="el" href="classEntityResolver.html#z425_0">EntityResolver::resolveEntity</a> </dl>
773<p>
774Implements <a class="el" href="classEntityResolver.html#z425_0">EntityResolver</a>.    </td>
775  </tr>
776</table>
777<a name="z429_0" doxytag="HandlerBase::setDocumentLocator"></a><p>
778<table width="100%" cellpadding="2" cellspacing="0" border="0">
779  <tr>
780    <td class="md">
781      <table cellpadding="0" cellspacing="0" border="0">
782        <tr>
783          <td class="md" nowrap valign="top"> void HandlerBase::setDocumentLocator </td>
784          <td class="md" valign="top">(&nbsp;</td>
785          <td class="md" nowrap valign="top">const <a class="el" href="classLocator.html">Locator</a> *const&nbsp;</td>
786          <td class="mdname1" valign="top" nowrap>&nbsp; <em>locator</em>          </td>
787          <td class="md" valign="top">)&nbsp;</td>
788          <td class="md" nowrap><code> [virtual]</code></td>
789        </tr>
790
791      </table>
792    </td>
793  </tr>
794</table>
795<table cellspacing=5 cellpadding=0 border=0>
796  <tr>
797    <td>
798      &nbsp;
799    </td>
800    <td>
801
802<p>
803Receive a <a class="el" href="classLocator.html">Locator</a> object for document events.
804<p>
805
806<p>
807By default, do nothing. Application writers may override this method in a subclass if they wish to store the locator for use with other document events.<dl compact><dt><b>
808Parameters: </b><dd>
809<table border=0 cellspacing=2 cellpadding=0>
810<tr><td valign=top><em>locator</em>&nbsp;</td><td>
811A locator for all SAX document events. </td></tr>
812</table>
813</dl><dl compact><dt><b>
814See also: </b><dd>
815<a class="el" href="classDocumentHandler.html#z421_6">DocumentHandler::setDocumentLocator</a> , <a class="el" href="classLocator.html">Locator</a> </dl>
816<p>
817Implements <a class="el" href="classDocumentHandler.html#z421_6">DocumentHandler</a>.    </td>
818  </tr>
819</table>
820<a name="z429_1" doxytag="HandlerBase::startDocument"></a><p>
821<table width="100%" cellpadding="2" cellspacing="0" border="0">
822  <tr>
823    <td class="md">
824      <table cellpadding="0" cellspacing="0" border="0">
825        <tr>
826          <td class="md" nowrap valign="top"> void HandlerBase::startDocument </td>
827          <td class="md" valign="top">(&nbsp;</td>
828          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
829          <td class="md" valign="top">)&nbsp;</td>
830          <td class="md" nowrap><code> [virtual]</code></td>
831        </tr>
832
833      </table>
834    </td>
835  </tr>
836</table>
837<table cellspacing=5 cellpadding=0 border=0>
838  <tr>
839    <td>
840      &nbsp;
841    </td>
842    <td>
843
844<p>
845Receive notification of the beginning of the document.
846<p>
847
848<p>
849By default, do nothing. Application writers may override this method in a subclass to take specific actions at the beginning of a document (such as allocating the root node of a tree or creating an output file).<dl compact><dt><b>
850Exceptions: </b><dd>
851<table border=0 cellspacing=2 cellpadding=0>
852<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
853 Any SAX exception, possibly wrapping another exception. </td></tr>
854</table>
855</dl><dl compact><dt><b>
856See also: </b><dd>
857<a class="el" href="classDocumentHandler.html#z421_7">DocumentHandler::startDocument</a> </dl>
858<p>
859Implements <a class="el" href="classDocumentHandler.html#z421_7">DocumentHandler</a>.    </td>
860  </tr>
861</table>
862<a name="z429_2" doxytag="HandlerBase::startElement"></a><p>
863<table width="100%" cellpadding="2" cellspacing="0" border="0">
864  <tr>
865    <td class="md">
866      <table cellpadding="0" cellspacing="0" border="0">
867        <tr>
868          <td class="md" nowrap valign="top"> void HandlerBase::startElement </td>
869          <td class="md" valign="top">(&nbsp;</td>
870          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
871          <td class="mdname" nowrap>&nbsp; <em>name</em>, </td>
872        </tr>
873        <tr>
874          <td></td>
875          <td></td>
876          <td class="md" nowrap><a class="el" href="classAttributeList.html">AttributeList</a> &amp;&nbsp;</td>
877          <td class="mdname" nowrap>&nbsp; <em>attributes</em></td>
878        </tr>
879        <tr>
880          <td></td>
881          <td class="md">)&nbsp;</td>
882          <td class="md" colspan="2"><code> [virtual]</code></td>
883        </tr>
884
885      </table>
886    </td>
887  </tr>
888</table>
889<table cellspacing=5 cellpadding=0 border=0>
890  <tr>
891    <td>
892      &nbsp;
893    </td>
894    <td>
895
896<p>
897Receive notification of the start of an element.
898<p>
899
900<p>
901By default, do nothing. Application writers may override this method in a subclass to take specific actions at the start of each element (such as allocating a new tree node or writing output to a file).<dl compact><dt><b>
902Parameters: </b><dd>
903<table border=0 cellspacing=2 cellpadding=0>
904<tr><td valign=top><em>name</em>&nbsp;</td><td>
905The element type name. </td></tr>
906<tr><td valign=top><em>attributes</em>&nbsp;</td><td>
907The specified or defaulted attributes. </td></tr>
908</table>
909</dl><dl compact><dt><b>
910Exceptions: </b><dd>
911<table border=0 cellspacing=2 cellpadding=0>
912<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
913 Any SAX exception, possibly wrapping another exception. </td></tr>
914</table>
915</dl><dl compact><dt><b>
916See also: </b><dd>
917<a class="el" href="classDocumentHandler.html#z421_8">DocumentHandler::startElement</a> </dl>
918<p>
919Implements <a class="el" href="classDocumentHandler.html#z421_8">DocumentHandler</a>.    </td>
920  </tr>
921</table>
922<a name="z432_2" doxytag="HandlerBase::unparsedEntityDecl"></a><p>
923<table width="100%" cellpadding="2" cellspacing="0" border="0">
924  <tr>
925    <td class="md">
926      <table cellpadding="0" cellspacing="0" border="0">
927        <tr>
928          <td class="md" nowrap valign="top"> void HandlerBase::unparsedEntityDecl </td>
929          <td class="md" valign="top">(&nbsp;</td>
930          <td class="md" nowrap valign="top">const XMLCh *const&nbsp;</td>
931          <td class="mdname" nowrap>&nbsp; <em>name</em>, </td>
932        </tr>
933        <tr>
934          <td></td>
935          <td></td>
936          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
937          <td class="mdname" nowrap>&nbsp; <em>publicId</em>, </td>
938        </tr>
939        <tr>
940          <td></td>
941          <td></td>
942          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
943          <td class="mdname" nowrap>&nbsp; <em>systemId</em>, </td>
944        </tr>
945        <tr>
946          <td></td>
947          <td></td>
948          <td class="md" nowrap>const XMLCh *const&nbsp;</td>
949          <td class="mdname" nowrap>&nbsp; <em>notationName</em></td>
950        </tr>
951        <tr>
952          <td></td>
953          <td class="md">)&nbsp;</td>
954          <td class="md" colspan="2"><code> [virtual]</code></td>
955        </tr>
956
957      </table>
958    </td>
959  </tr>
960</table>
961<table cellspacing=5 cellpadding=0 border=0>
962  <tr>
963    <td>
964      &nbsp;
965    </td>
966    <td>
967
968<p>
969Receive notification of an unparsed entity declaration.
970<p>
971
972<p>
973By default, do nothing. Application writers may override this method in a subclass to keep track of the unparsed entities declared in a document.<dl compact><dt><b>
974Parameters: </b><dd>
975<table border=0 cellspacing=2 cellpadding=0>
976<tr><td valign=top><em>name</em>&nbsp;</td><td>
977The entity name. </td></tr>
978<tr><td valign=top><em>publicId</em>&nbsp;</td><td>
979The entity public identifier, or null if not available. </td></tr>
980<tr><td valign=top><em>systemId</em>&nbsp;</td><td>
981The entity system identifier. </td></tr>
982<tr><td valign=top><em>notationName</em>&nbsp;</td><td>
983The name of the associated notation. </td></tr>
984</table>
985</dl><dl compact><dt><b>
986See also: </b><dd>
987<a class="el" href="classDTDHandler.html#z423_1">DTDHandler::unparsedEntityDecl</a> </dl>
988<p>
989Implements <a class="el" href="classDTDHandler.html#z423_1">DTDHandler</a>.    </td>
990  </tr>
991</table>
992<a name="z431_2" doxytag="HandlerBase::warning"></a><p>
993<table width="100%" cellpadding="2" cellspacing="0" border="0">
994  <tr>
995    <td class="md">
996      <table cellpadding="0" cellspacing="0" border="0">
997        <tr>
998          <td class="md" nowrap valign="top"> void HandlerBase::warning </td>
999          <td class="md" valign="top">(&nbsp;</td>
1000          <td class="md" nowrap valign="top">const <a class="el" href="classSAXParseException.html">SAXParseException</a> &amp;&nbsp;</td>
1001          <td class="mdname1" valign="top" nowrap>&nbsp; <em>exc</em>          </td>
1002          <td class="md" valign="top">)&nbsp;</td>
1003          <td class="md" nowrap><code> [virtual]</code></td>
1004        </tr>
1005
1006      </table>
1007    </td>
1008  </tr>
1009</table>
1010<table cellspacing=5 cellpadding=0 border=0>
1011  <tr>
1012    <td>
1013      &nbsp;
1014    </td>
1015    <td>
1016
1017<p>
1018Receive notification of a parser warning.
1019<p>
1020
1021<p>
1022The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each warning, such as inserting the message in a log file or printing it to the console.<dl compact><dt><b>
1023Parameters: </b><dd>
1024<table border=0 cellspacing=2 cellpadding=0>
1025<tr><td valign=top><em>exc</em>&nbsp;</td><td>
1026The warning information encoded as an exception. </td></tr>
1027</table>
1028</dl><dl compact><dt><b>
1029Exceptions: </b><dd>
1030<table border=0 cellspacing=2 cellpadding=0>
1031<tr><td valign=top><em><a class="el" href="classSAXException.html">SAXException</a></em>&nbsp;</td><td>
1032 Any SAX exception, possibly wrapping another exception. </td></tr>
1033</table>
1034</dl><dl compact><dt><b>
1035See also: </b><dd>
1036<a class="el" href="classErrorHandler.html#z427_0">ErrorHandler::warning</a> , <a class="el" href="classSAXParseException.html#z445_0">SAXParseException::SAXParseException</a> </dl>
1037<p>
1038Implements <a class="el" href="classErrorHandler.html#z427_0">ErrorHandler</a>.    </td>
1039  </tr>
1040</table>
1041<hr>The documentation for this class was generated from the following file:<ul>
1042<li><a class="el" href="HandlerBase_8hpp-source.html">HandlerBase.hpp</a></ul>
1043    </FONT></TD></TR></TABLE><BR>
1044</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>
1045              Copyright &copy; 1994-2004 The Apache Software Foundation.
1046              All Rights Reserved.
1047            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.