<h1>xercesc::LocalFileInputSource Class Reference</h1><!-- doxytag: class="xercesc::LocalFileInputSource" --><!-- doxytag: inherits="xercesc::InputSource" -->This class is a derivative of the standard <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> class.
Inheritance diagram for xercesc::LocalFileInputSource:<p><center><imgsrc="classxercesc_1_1LocalFileInputSource__inherit__graph.png"border="0"usemap="#xercesc_1_1LocalFileInputSource__inherit__map"alt="Inheritance graph"></center>
<center><fontsize="2">[<ahref="graph_legend.html">legend</a>]</font></center><ahref="classxercesc_1_1LocalFileInputSource-members.html">List of all members.</a><tableborder="0"cellpadding="0"cellspacing="0">
<tr><td></td></tr>
<tr><tdcolspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">This method will return a binary input stream derivative that will parse from the local file indicatedby the system id. <ahref="#b080ba29fdbc0825da80cdce64f38007"></a><br></td></tr>
This class is a derivative of the standard <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> class.
<p>
It provides for the parser access to data which is referenced via a local file path, as apposed to remote file or URL. This is the most efficacious mechanism by which local files can be parsed, since the parse knows that it refers to a local file and will make no other attempts to interpret the passed path.<p>
The path provided can either be a fully qualified path or a relative path. If relative, it will be completed either relative to a passed base path or relative to the current working directory of the process.<p>
As with all <aclass="el"href="classxercesc_1_1InputSource.html">InputSource</a> derivatives. The primary objective of an input source is to create an input stream via which the parser can spool in data from the referenced source.
<p>
<hr><h2>Constructor & Destructor Documentation</h2>
A local file input source requires a path to the file to load.
<p>
This can be provided either as a fully qualified path, a path relative to the current working directly, or a path relative to a provided base path.<p>
The completed path will become the system id of this input source. The constructors don't take any public id for local files, but you still set them via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method of course.<p>
This constructor takes an explicit base path and a possibly relative path. If the relative path is seen to be fully qualified, it is used as is. Otherwise, it is made relative to the passed base path.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>basePath</em> </td><td>The base path from which the passed relative path will be based, if the relative part is indeed relative.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>relativePath</em> </td><td>The relative part of the path. It can actually be fully qualified, in which case it is taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects.</td></tr>
</table>
</dl>
<dlcompact><dt><b>Exceptions:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>XMLException</em> </td><td>If the path is relative and doesn't properly resolve to a file. </td></tr>
This constructor takes a single parameter which is the fully qualified or relative path.
<p>
If it is fully qualified, it is taken as is. If it is relative, then it is completed relative to the current working directory (or the equivalent on the local host machine.)<p>
The completed path will become the system id of this input source. The constructors don't take any public id for local files, but you still set them via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method of course.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>filePath</em> </td><td>The relative or fully qualified path.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects.</td></tr>
</table>
</dl>
<dlcompact><dt><b>Exceptions:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>XMLException</em> </td><td>If the path is relative and doesn't properly resolve to a file. </td></tr>
A local file input source requires a path to the file to load.
<p>
This can be provided either as a fully qualified path, a path relative to the current working directly, or a path relative to a provided base path.<p>
The completed path will become the system id of this input source. The constructors don't take any public id for local files, but you still set them via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method of course.<p>
This constructor takes an explicit base path and a possibly relative path. If the relative path is seen to be fully qualified, it is used as is. Otherwise, it is made relative to the passed base path.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>basePath</em> </td><td>The base path from which the passed relative path will be based, if the relative part is indeed relative.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>relativePath</em> </td><td>The relative part of the path. It can actually be fully qualified, in which case it is taken as is.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects.</td></tr>
</table>
</dl>
<dlcompact><dt><b>Exceptions:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>XMLException</em> </td><td>If the path is relative and doesn't properly resolve to a file. </td></tr>
This constructor takes a single parameter which is the fully qualified or relative path.
<p>
If it is fully qualified, it is taken as is. If it is relative, then it is completed relative to the current working directory (or the equivalent on the local host machine.)<p>
The completed path will become the system id of this input source. The constructors don't take any public id for local files, but you still set them via the parent class' <aclass="el"href="classxercesc_1_1InputSource.html#d88b92735d82dcadf39496ca83357aec">setPublicId()</a> method of course.<p>
<dlcompact><dt><b>Parameters:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>filePath</em> </td><td>The relative or fully qualified path.</td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </td><td>Pointer to the memory manager to be used to allocate objects.</td></tr>
</table>
</dl>
<dlcompact><dt><b>Exceptions:</b></dt><dd>
<tableborder="0"cellspacing="2"cellpadding="0">
<tr><tdvalign="top"></td><tdvalign="top"><em>XMLException</em> </td><td>If the path is relative and doesn't properly resolve to a file. </td></tr>
<dlclass="return"compact><dt><b>Returns:</b></dt><dd>A dynamically allocated binary input stream derivative that can parse from the file indicated by the system id. </dd></dl>
