|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2 |
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
|
3 |
<title>Xerces-C++: Parser Class Reference</title> |
|
4 |
<link href="doxygen.css" rel="stylesheet" type="text/css"> |
|
5 |
<link href="tabs.css" rel="stylesheet" type="text/css"> |
|
6 |
</head><body> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
7 |
<!-- Generated by Doxygen 1.5.6 -->
|
8 |
<div class="navigation" id="top"> |
|
9 |
<div class="tabs"> |
|
10 |
<ul> |
|
11 |
<li><a href="index.html"><span>Main Page</span></a></li> |
|
12 |
<li><a href="pages.html"><span>Related Pages</span></a></li> |
|
13 |
<li class="current"><a href="classes.html"><span>Classes</span></a></li> |
|
14 |
<li><a href="files.html"><span>Files</span></a></li> |
|
15 |
</ul> |
|
16 |
</div> |
|
17 |
<div class="tabs"> |
|
18 |
<ul> |
|
19 |
<li><a href="classes.html"><span>Alphabetical List</span></a></li> |
|
20 |
<li><a href="annotated.html"><span>Class List</span></a></li> |
|
21 |
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li> |
|
22 |
<li><a href="functions.html"><span>Class Members</span></a></li> |
|
23 |
</ul> |
|
24 |
</div> |
|
25 |
</div> |
|
26 |
<div class="contents"> |
|
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
27 |
<h1>Parser Class Reference</h1><!-- doxytag: class="Parser" -->Basic interface for SAX (Simple API for XML) parsers. |
28 |
<a href="#_details">More...</a> |
|
29 |
<p> |
|
30 |
<div class="dynheader"> |
|
31 |
Inheritance diagram for Parser:</div> |
|
32 |
<div class="dynsection"> |
|
33 |
||
34 |
<p><center><img src="classParser.png" usemap="#Parser_map" border="0" alt=""></center> |
|
35 |
<map name="Parser_map"> |
|
36 |
<area href="classSAXParser.html" alt="SAXParser" shape="rect" coords="0,56,76,80"> |
|
37 |
</map> |
|
38 |
</div> |
|
39 |
||
40 |
<p> |
|
41 |
<a href="classParser-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0"> |
|
42 |
<tr><td></td></tr> |
|
43 |
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr> |
|
44 |
<tr><td colspan="2"><div class="groupHeader">Constructors and Destructor</div></td></tr> |
|
45 |
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#12234f6cd36b61af4b50c94a179422c1">Parser</a> ()</td></tr> |
|
46 |
||
47 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">The default constructor. <a href="#12234f6cd36b61af4b50c94a179422c1"></a><br></td></tr> |
|
48 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#d576b92b9cc324f6f41b0269a9a1a546">~Parser</a> ()</td></tr> |
|
49 |
||
50 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <a href="#d576b92b9cc324f6f41b0269a9a1a546"></a><br></td></tr> |
|
51 |
<tr><td colspan="2"><div class="groupHeader">The parser interfaces</div></td></tr> |
|
52 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#62435895e0615380f3017090ac232594">setEntityResolver</a> (<a class="el" href="classEntityResolver.html">EntityResolver</a> *const resolver)=0</td></tr> |
|
53 |
||
54 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a custom entity resolver. <a href="#62435895e0615380f3017090ac232594"></a><br></td></tr> |
|
55 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#d97184f9e4397e360903e2fdb72d23bf">setDTDHandler</a> (<a class="el" href="classDTDHandler.html">DTDHandler</a> *const handler)=0</td></tr> |
|
56 |
||
57 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a DTD event handler. <a href="#d97184f9e4397e360903e2fdb72d23bf"></a><br></td></tr> |
|
58 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#2038c09146fff3b0ec66143630736bdb">setDocumentHandler</a> (<a class="el" href="classDocumentHandler.html">DocumentHandler</a> *const handler)=0</td></tr> |
|
59 |
||
60 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register a document event handler. <a href="#2038c09146fff3b0ec66143630736bdb"></a><br></td></tr> |
|
61 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#acd0f62732e363faeb4e5ee5b0a6e12a">setErrorHandler</a> (<a class="el" href="classErrorHandler.html">ErrorHandler</a> *const handler)=0</td></tr> |
|
62 |
||
63 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Allow an application to register an error event handler. <a href="#acd0f62732e363faeb4e5ee5b0a6e12a"></a><br></td></tr> |
|
64 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#624fc687a49b917c11ef632367568b60">parse</a> (const <a class="el" href="classInputSource.html">InputSource</a> &source)=0</td></tr> |
|
65 |
||
66 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document. <a href="#624fc687a49b917c11ef632367568b60"></a><br></td></tr> |
|
67 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#37d4db3b3e88307b0aad780a685d76fd">parse</a> (const <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#fae8f92d83170d97f757f704eca7f52a">XMLCh</a> *const systemId)=0</td></tr> |
|
68 |
||
69 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document from a system identifier (URI). <a href="#37d4db3b3e88307b0aad780a685d76fd"></a><br></td></tr> |
|
70 |
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classParser.html#802e068db2ca0b11d8f6365d8a3267c6">parse</a> (const char *const systemId)=0</td></tr> |
|
71 |
||
72 |
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse an XML document from a system identifier (URI). <a href="#802e068db2ca0b11d8f6365d8a3267c6"></a><br></td></tr> |
|
73 |
</table> |
|
74 |
<hr><a name="_details"></a><h2>Detailed Description</h2> |
|
75 |
Basic interface for SAX (Simple API for XML) parsers. |
|
76 |
<p> |
|
77 |
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> |
|
78 |
All SAX parsers must also implement a zero-argument constructor (though other constructors are also allowed).<p> |
|
79 |
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#624fc687a49b917c11ef632367568b60" title="Parse an XML document.">parse()</a> methods recursively within a parse.<p> |
|
80 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classEntityResolver.html#14e534eb2170015056ccd71458e1058c" title="Default Constructor.">EntityResolver::EntityResolver</a> <p> |
|
81 |
<a class="el" href="classDTDHandler.html#1d17e15d976164f6d55f542759eea182" title="Default Constructor.">DTDHandler::DTDHandler</a> <p> |
|
82 |
<a class="el" href="classDocumentHandler.html#c24bb98e06d7db2b0823816eec2f6c19" title="Default constructor.">DocumentHandler::DocumentHandler</a> <p> |
|
83 |
<a class="el" href="classErrorHandler.html#7e5f379bd231442b898cef94556b2107" title="Default constructor.">ErrorHandler::ErrorHandler</a> <p> |
|
84 |
<a class="el" href="classHandlerBase.html#a9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> <p> |
|
85 |
<a class="el" href="classInputSource.html#601a7aa7124e2d8e9664eda9aea6b622" title="Default constructor.">InputSource::InputSource</a> </dd></dl> |
|
86 |
<hr><h2>Constructor & Destructor Documentation</h2> |
|
87 |
<a class="anchor" name="12234f6cd36b61af4b50c94a179422c1"></a><!-- doxytag: member="Parser::Parser" ref="12234f6cd36b61af4b50c94a179422c1" args="()" --> |
|
88 |
<div class="memitem"> |
|
89 |
<div class="memproto"> |
|
90 |
<table class="memname"> |
|
91 |
<tr> |
|
92 |
<td class="memname">Parser::Parser </td> |
|
93 |
<td>(</td> |
|
94 |
<td class="paramname"> </td> |
|
95 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
96 |
<td></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
97 |
</tr> |
98 |
</table> |
|
99 |
</div> |
|
100 |
<div class="memdoc"> |
|
101 |
||
102 |
<p> |
|
103 |
The default constructor. |
|
104 |
<p> |
|
105 |
||
106 |
</div> |
|
107 |
</div><p> |
|
108 |
<a class="anchor" name="d576b92b9cc324f6f41b0269a9a1a546"></a><!-- doxytag: member="Parser::~Parser" ref="d576b92b9cc324f6f41b0269a9a1a546" args="()" --> |
|
109 |
<div class="memitem"> |
|
110 |
<div class="memproto"> |
|
111 |
<table class="memname"> |
|
112 |
<tr> |
|
113 |
<td class="memname">virtual Parser::~Parser </td> |
|
114 |
<td>(</td> |
|
115 |
<td class="paramname"> </td> |
|
116 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
117 |
<td><code> [virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
118 |
</tr> |
119 |
</table> |
|
120 |
</div> |
|
121 |
<div class="memdoc"> |
|
122 |
||
123 |
<p> |
|
124 |
The destructor. |
|
125 |
<p> |
|
126 |
||
127 |
</div> |
|
128 |
</div><p> |
|
129 |
<hr><h2>Member Function Documentation</h2> |
|
130 |
<a class="anchor" name="62435895e0615380f3017090ac232594"></a><!-- doxytag: member="Parser::setEntityResolver" ref="62435895e0615380f3017090ac232594" args="(EntityResolver *const resolver)=0" --> |
|
131 |
<div class="memitem"> |
|
132 |
<div class="memproto"> |
|
133 |
<table class="memname"> |
|
134 |
<tr> |
|
135 |
<td class="memname">virtual void Parser::setEntityResolver </td> |
|
136 |
<td>(</td> |
|
137 |
<td class="paramtype"><a class="el" href="classEntityResolver.html">EntityResolver</a> *const </td> |
|
138 |
<td class="paramname"> <em>resolver</em> </td> |
|
139 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
140 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
141 |
</tr> |
142 |
</table> |
|
143 |
</div> |
|
144 |
<div class="memdoc"> |
|
145 |
||
146 |
<p> |
|
147 |
Allow an application to register a custom entity resolver. |
|
148 |
<p> |
|
149 |
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> |
|
150 |
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> |
|
151 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
152 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
153 |
<tr><td valign="top"></td><td valign="top"><em>resolver</em> </td><td>The object for resolving entities. </td></tr> |
|
154 |
</table> |
|
155 |
</dl> |
|
156 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classEntityResolver.html#14e534eb2170015056ccd71458e1058c" title="Default Constructor.">EntityResolver::EntityResolver</a> <p> |
|
157 |
<a class="el" href="classHandlerBase.html#a9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl> |
|
158 |
||
159 |
<p>Implemented in <a class="el" href="classSAXParser.html#55ca3032890cc8893cfcfc15753db57b">SAXParser</a>.</p> |
|
160 |
||
161 |
</div> |
|
162 |
</div><p> |
|
163 |
<a class="anchor" name="d97184f9e4397e360903e2fdb72d23bf"></a><!-- doxytag: member="Parser::setDTDHandler" ref="d97184f9e4397e360903e2fdb72d23bf" args="(DTDHandler *const handler)=0" --> |
|
164 |
<div class="memitem"> |
|
165 |
<div class="memproto"> |
|
166 |
<table class="memname"> |
|
167 |
<tr> |
|
168 |
<td class="memname">virtual void Parser::setDTDHandler </td> |
|
169 |
<td>(</td> |
|
170 |
<td class="paramtype"><a class="el" href="classDTDHandler.html">DTDHandler</a> *const </td> |
|
171 |
<td class="paramname"> <em>handler</em> </td> |
|
172 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
173 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
174 |
</tr> |
175 |
</table> |
|
176 |
</div> |
|
177 |
<div class="memdoc"> |
|
178 |
||
179 |
<p> |
|
180 |
Allow an application to register a DTD event handler. |
|
181 |
<p> |
|
182 |
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> |
|
183 |
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> |
|
184 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
185 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
186 |
<tr><td valign="top"></td><td valign="top"><em>handler</em> </td><td>The DTD handler. </td></tr> |
|
187 |
</table> |
|
188 |
</dl> |
|
189 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classDTDHandler.html#1d17e15d976164f6d55f542759eea182" title="Default Constructor.">DTDHandler::DTDHandler</a> <p> |
|
190 |
<a class="el" href="classHandlerBase.html#a9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl> |
|
191 |
||
192 |
<p>Implemented in <a class="el" href="classSAXParser.html#718d0f982508496ac008a1b4f20eba06">SAXParser</a>.</p> |
|
193 |
||
194 |
</div> |
|
195 |
</div><p> |
|
196 |
<a class="anchor" name="2038c09146fff3b0ec66143630736bdb"></a><!-- doxytag: member="Parser::setDocumentHandler" ref="2038c09146fff3b0ec66143630736bdb" args="(DocumentHandler *const handler)=0" --> |
|
197 |
<div class="memitem"> |
|
198 |
<div class="memproto"> |
|
199 |
<table class="memname"> |
|
200 |
<tr> |
|
201 |
<td class="memname">virtual void Parser::setDocumentHandler </td> |
|
202 |
<td>(</td> |
|
203 |
<td class="paramtype"><a class="el" href="classDocumentHandler.html">DocumentHandler</a> *const </td> |
|
204 |
<td class="paramname"> <em>handler</em> </td> |
|
205 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
206 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
207 |
</tr> |
208 |
</table> |
|
209 |
</div> |
|
210 |
<div class="memdoc"> |
|
211 |
||
212 |
<p> |
|
213 |
Allow an application to register a document event handler. |
|
214 |
<p> |
|
215 |
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> |
|
216 |
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> |
|
217 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
218 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
219 |
<tr><td valign="top"></td><td valign="top"><em>handler</em> </td><td>The document handler. </td></tr> |
|
220 |
</table> |
|
221 |
</dl> |
|
222 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classDocumentHandler.html#c24bb98e06d7db2b0823816eec2f6c19" title="Default constructor.">DocumentHandler::DocumentHandler</a> <p> |
|
223 |
<a class="el" href="classHandlerBase.html#a9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl> |
|
224 |
||
225 |
<p>Implemented in <a class="el" href="classSAXParser.html#f8593f6ca5ebb7c96d63eaea6935b1a9">SAXParser</a>.</p> |
|
226 |
||
227 |
</div> |
|
228 |
</div><p> |
|
229 |
<a class="anchor" name="acd0f62732e363faeb4e5ee5b0a6e12a"></a><!-- doxytag: member="Parser::setErrorHandler" ref="acd0f62732e363faeb4e5ee5b0a6e12a" args="(ErrorHandler *const handler)=0" --> |
|
230 |
<div class="memitem"> |
|
231 |
<div class="memproto"> |
|
232 |
<table class="memname"> |
|
233 |
<tr> |
|
234 |
<td class="memname">virtual void Parser::setErrorHandler </td> |
|
235 |
<td>(</td> |
|
236 |
<td class="paramtype"><a class="el" href="classErrorHandler.html">ErrorHandler</a> *const </td> |
|
237 |
<td class="paramname"> <em>handler</em> </td> |
|
238 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
239 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
240 |
</tr> |
241 |
</table> |
|
242 |
</div> |
|
243 |
<div class="memdoc"> |
|
244 |
||
245 |
<p> |
|
246 |
Allow an application to register an error event handler. |
|
247 |
<p> |
|
248 |
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> |
|
249 |
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> |
|
250 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
251 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
252 |
<tr><td valign="top"></td><td valign="top"><em>handler</em> </td><td>The error handler. </td></tr> |
|
253 |
</table> |
|
254 |
</dl> |
|
255 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classErrorHandler.html#7e5f379bd231442b898cef94556b2107" title="Default constructor.">ErrorHandler::ErrorHandler</a> <p> |
|
256 |
<a class="el" href="classSAXException.html#e1c8ab9b99e3c43572c1567e72c652e4" title="Default constructor.">SAXException::SAXException</a> <p> |
|
257 |
<a class="el" href="classHandlerBase.html#a9bbcdb7958bace9296940ab702ef367">HandlerBase::HandlerBase</a> </dd></dl> |
|
258 |
||
259 |
<p>Implemented in <a class="el" href="classSAXParser.html#4f473c91401970cfaed6147caaa41cbd">SAXParser</a>.</p> |
|
260 |
||
261 |
</div> |
|
262 |
</div><p> |
|
263 |
<a class="anchor" name="624fc687a49b917c11ef632367568b60"></a><!-- doxytag: member="Parser::parse" ref="624fc687a49b917c11ef632367568b60" args="(const InputSource &source)=0" --> |
|
264 |
<div class="memitem"> |
|
265 |
<div class="memproto"> |
|
266 |
<table class="memname"> |
|
267 |
<tr> |
|
268 |
<td class="memname">virtual void Parser::parse </td> |
|
269 |
<td>(</td> |
|
270 |
<td class="paramtype">const <a class="el" href="classInputSource.html">InputSource</a> & </td> |
|
271 |
<td class="paramname"> <em>source</em> </td> |
|
272 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
273 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
274 |
</tr> |
275 |
</table> |
|
276 |
</div> |
|
277 |
<div class="memdoc"> |
|
278 |
||
279 |
<p> |
|
280 |
Parse an XML document. |
|
281 |
<p> |
|
282 |
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> |
|
283 |
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> |
|
284 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
285 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
286 |
<tr><td valign="top"></td><td valign="top"><em>source</em> </td><td>The input source for the top-level of the XML document. </td></tr> |
|
287 |
</table> |
|
288 |
</dl> |
|
289 |
<dl compact><dt><b>Exceptions:</b></dt><dd> |
|
290 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
291 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning.">SAXException</a></em> </td><td>Any SAX exception, possibly wrapping another exception. </td></tr> |
|
292 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXMLException.html">XMLException</a></em> </td><td>An exception from the parser or client handler code. </td></tr> |
|
293 |
</table> |
|
294 |
</dl> |
|
295 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classInputSource.html#601a7aa7124e2d8e9664eda9aea6b622" title="Default constructor.">InputSource::InputSource</a> <p> |
|
296 |
<a class="el" href="classParser.html#62435895e0615380f3017090ac232594" title="Allow an application to register a custom entity resolver.">setEntityResolver</a> <p> |
|
297 |
<a class="el" href="classParser.html#d97184f9e4397e360903e2fdb72d23bf" title="Allow an application to register a DTD event handler.">setDTDHandler</a> <p> |
|
298 |
<a class="el" href="classParser.html#2038c09146fff3b0ec66143630736bdb" title="Allow an application to register a document event handler.">setDocumentHandler</a> <p> |
|
299 |
<a class="el" href="classParser.html#acd0f62732e363faeb4e5ee5b0a6e12a" title="Allow an application to register an error event handler.">setErrorHandler</a> </dd></dl> |
|
300 |
||
301 |
<p>Implemented in <a class="el" href="classSAXParser.html#d684882ed98a172675553abe68109666">SAXParser</a>.</p> |
|
302 |
||
303 |
</div> |
|
304 |
</div><p> |
|
305 |
<a class="anchor" name="37d4db3b3e88307b0aad780a685d76fd"></a><!-- doxytag: member="Parser::parse" ref="37d4db3b3e88307b0aad780a685d76fd" args="(const XMLCh *const systemId)=0" --> |
|
306 |
<div class="memitem"> |
|
307 |
<div class="memproto"> |
|
308 |
<table class="memname"> |
|
309 |
<tr> |
|
310 |
<td class="memname">virtual void Parser::parse </td> |
|
311 |
<td>(</td> |
|
312 |
<td class="paramtype">const <a class="el" href="Xerces__autoconf__config_8msvc_8hpp.html#fae8f92d83170d97f757f704eca7f52a">XMLCh</a> *const </td> |
|
313 |
<td class="paramname"> <em>systemId</em> </td> |
|
314 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
315 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
316 |
</tr> |
317 |
</table> |
|
318 |
</div> |
|
319 |
<div class="memdoc"> |
|
320 |
||
321 |
<p> |
|
322 |
Parse an XML document from a system identifier (URI). |
|
323 |
<p> |
|
324 |
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> |
|
325 |
parse(new URLInputSource(systemId));<p> |
|
326 |
If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.<p> |
|
327 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
328 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
329 |
<tr><td valign="top"></td><td valign="top"><em>systemId</em> </td><td>The system identifier (URI). </td></tr> |
|
330 |
</table> |
|
331 |
</dl> |
|
332 |
<dl compact><dt><b>Exceptions:</b></dt><dd> |
|
333 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
334 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning.">SAXException</a></em> </td><td>Any SAX exception, possibly wrapping another exception. </td></tr> |
|
335 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXMLException.html">XMLException</a></em> </td><td>An exception from the parser or client handler code. </td></tr> |
|
336 |
</table> |
|
337 |
</dl> |
|
338 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classParser.html#624fc687a49b917c11ef632367568b60" title="Parse an XML document.">parse(const InputSource&)</a> </dd></dl> |
|
339 |
||
340 |
<p>Implemented in <a class="el" href="classSAXParser.html#4a5146bda42a0ba972a6fbd77146e828">SAXParser</a>.</p> |
|
341 |
||
342 |
</div> |
|
343 |
</div><p> |
|
344 |
<a class="anchor" name="802e068db2ca0b11d8f6365d8a3267c6"></a><!-- doxytag: member="Parser::parse" ref="802e068db2ca0b11d8f6365d8a3267c6" args="(const char *const systemId)=0" --> |
|
345 |
<div class="memitem"> |
|
346 |
<div class="memproto"> |
|
347 |
<table class="memname"> |
|
348 |
<tr> |
|
349 |
<td class="memname">virtual void Parser::parse </td> |
|
350 |
<td>(</td> |
|
351 |
<td class="paramtype">const char *const </td> |
|
352 |
<td class="paramname"> <em>systemId</em> </td> |
|
353 |
<td> ) </td> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
354 |
<td><code> [pure virtual]</code></td> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
355 |
</tr> |
356 |
</table> |
|
357 |
</div> |
|
358 |
<div class="memdoc"> |
|
359 |
||
360 |
<p> |
|
361 |
Parse an XML document from a system identifier (URI). |
|
362 |
<p> |
|
363 |
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> |
|
364 |
parse(new URLInputSource(systemId));<p> |
|
365 |
If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.<p> |
|
366 |
<dl compact><dt><b>Parameters:</b></dt><dd> |
|
367 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
368 |
<tr><td valign="top"></td><td valign="top"><em>systemId</em> </td><td>The system identifier (URI). </td></tr> |
|
369 |
</table> |
|
370 |
</dl> |
|
371 |
<dl compact><dt><b>Exceptions:</b></dt><dd> |
|
372 |
<table border="0" cellspacing="2" cellpadding="0"> |
|
373 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classSAXException.html" title="Encapsulate a general SAX error or warning.">SAXException</a></em> </td><td>Any SAX exception, possibly wrapping another exception. </td></tr> |
|
374 |
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXMLException.html">XMLException</a></em> </td><td>An exception from the parser or client handler code. </td></tr> |
|
375 |
</table> |
|
376 |
</dl> |
|
377 |
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classParser.html#624fc687a49b917c11ef632367568b60" title="Parse an XML document.">parse(const InputSource&)</a> </dd></dl> |
|
378 |
||
379 |
<p>Implemented in <a class="el" href="classSAXParser.html#6e928e936c15ef184fd286380e9f8c14">SAXParser</a>.</p> |
|
380 |
||
381 |
</div> |
|
382 |
</div><p> |
|
383 |
<hr>The documentation for this class was generated from the following file:<ul> |
|
384 |
<li><a class="el" href="Parser_8hpp-source.html">Parser.hpp</a></ul> |
|
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
385 |
</div> |
386 |
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 24 13:49:53 2009 for Xerces-C++ by |
|
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
387 |
<a href="http://www.doxygen.org/index.html"> |
|
1.1.1
by Jay Berkenbilt
Import upstream version 3.1.0~rc1 |
388 |
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address> |
|
1
by Jay Berkenbilt
Import upstream version 3.0.1 |
389 |
</body> |
390 |
</html> |