blob: ec05b9779fd8365762f762079307296cbaacab33 [file] [log] [blame]
<HTML><HEAD><SCRIPT language="JavaScript" src="../resources/script.js" type="text/javascript"></SCRIPT><TITLE>Xerces-C++: XMLPlatformUtils 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>
<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>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<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>
<A href="../charter.html" onMouseOut="rolloverOff('side-charter');" onMouseOver="rolloverOn('side-charter');"><IMG alt="Charter" border="0" height="12" hspace="0" name="side-charter" onLoad="rolloverLoad('side-charter','../graphics/charter-label-2.jpg','../graphics/charter-label-3.jpg');" src="../graphics/charter-label-3.jpg" vspace="0" width="120"></A><BR>
<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>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<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>
<A href="http://xerces.apache.org/xerces-c/download.cgi" onMouseOut="rolloverOff('side-ext-20');" onMouseOver="rolloverOn('side-ext-20');"><IMG alt="Download" border="0" height="12" hspace="0" name="side-ext-20" onLoad="rolloverLoad('side-ext-20','../graphics/ext-20-label-2.jpg','../graphics/ext-20-label-3.jpg');" src="../graphics/ext-20-label-3.jpg" vspace="0" width="120"></A><BR>
<A href="../build.html" onMouseOut="rolloverOff('side-build');" onMouseOver="rolloverOn('side-build');"><IMG alt="Build Instructions" 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>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<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>
<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>
<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>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<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>
<A href="../ApacheDOMC++Binding.html" onMouseOut="rolloverOff('side-ext-88');" onMouseOver="rolloverOn('side-ext-88');"><IMG alt="DOM C++ Binding" border="0" height="12" hspace="0" name="side-ext-88" onLoad="rolloverLoad('side-ext-88','../graphics/ext-88-label-2.jpg','../graphics/ext-88-label-3.jpg');" src="../graphics/ext-88-label-3.jpg" vspace="0" width="120"></A><BR>
<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>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<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>
<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>
<A href="../mailing-lists.html" onMouseOut="rolloverOff('side-mailing-lists');" onMouseOver="rolloverOn('side-mailing-lists');"><IMG alt="Mailing Lists" border="0" height="12" hspace="0" name="side-mailing-lists" onLoad="rolloverLoad('side-mailing-lists','../graphics/mailing-lists-label-2.jpg','../graphics/mailing-lists-label-3.jpg');" src="../graphics/mailing-lists-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
<A href="../source-repository.html" onMouseOut="rolloverOff('side-source-repository');" onMouseOver="rolloverOn('side-source-repository');"><IMG alt="Source Repository" border="0" height="12" hspace="0" name="side-source-repository" onLoad="rolloverLoad('side-source-repository','../graphics/source-repository-label-2.jpg','../graphics/source-repository-label-3.jpg');" src="../graphics/source-repository-label-3.jpg" vspace="0" width="120"></A><BR>
<A href="../applications.html" onMouseOut="rolloverOff('side-applications');" onMouseOver="rolloverOn('side-applications');"><IMG alt="Applications" border="0" height="12" hspace="0" name="side-applications" onLoad="rolloverLoad('side-applications','../graphics/applications-label-2.jpg','../graphics/applications-label-3.jpg');" src="../graphics/applications-label-3.jpg" vspace="0" width="120"></A><BR>
<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>
<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">
<P>
<!-- Generated by Doxygen 1.5.3 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical&nbsp;List</span></a></li>
<li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
<li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
</ul>
</div>
<h1>XMLPlatformUtils Class Reference</h1><!-- doxytag: class="XMLPlatformUtils" -->Utilities that must be implemented in a platform-specific way.
<a href="#_details">More...</a>
<p>
<p>
<a href="classXMLPlatformUtils-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static size_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#a9ebaf28b01ef8a55652ce099e6e2982">alignPointerForNewBlockAllocation</a> (size_t ptrSize)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Aligns the specified pointer per platform block allocation requirements. <a href="#a9ebaf28b01ef8a55652ce099e6e2982"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Initialization amd Panic methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#378a0935e1d80c64b7a53dc35baad8f6">Initialize</a> (const char *const locale=<a class="el" href="classXMLUni.html#65fb61efef197f1387836a339477ab5e">XMLUni::fgXercescDefaultLocale</a>, const char *const nlsHome=0, <a class="el" href="classPanicHandler.html">PanicHandler</a> *const panicHandler=0, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const memoryManager=0, bool toInitStatics=false)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Perform per-process parser initialization. <a href="#378a0935e1d80c64b7a53dc35baad8f6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#dc0dcc57907126e06a2f5e376b392794">Terminate</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Perform per-process parser termination. <a href="#dc0dcc57907126e06a2f5e376b392794"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#b07bdc9abed13b76519c88b166cd6442">panic</a> (const <a class="el" href="classPanicHandler.html#ace4c4f408d68f168e1c2537e0ba5be2">PanicHandler::PanicReasons</a> reason)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The panic mechanism. <a href="#b07bdc9abed13b76519c88b166cd6442"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">File Methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#8c57d8d9cb96dc7b49aeca2db5f438eb">curFilePos</a> (FileHandle theFile, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the current file position. <a href="#8c57d8d9cb96dc7b49aeca2db5f438eb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#a0398de86ccca867efb18f73ec8a82f4">closeFile</a> (FileHandle theFile, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Closes the file handle. <a href="#a0398de86ccca867efb18f73ec8a82f4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#6a5d50b2d88d4368e71325e65dfc5342">fileSize</a> (FileHandle theFile, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns the file size. <a href="#6a5d50b2d88d4368e71325e65dfc5342"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static FileHandle&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#98eadae95169c66853c8264438505907">openFile</a> (const char *const fileName, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Opens the file. <a href="#98eadae95169c66853c8264438505907"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static FileHandle&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#5632167e9027b6def671ed4571ccf0bf">openFile</a> (const XMLCh *const fileName, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Opens a named file. <a href="#5632167e9027b6def671ed4571ccf0bf"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static FileHandle&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#5939d893ef7399d9d770be562bea6cfb">openFileToWrite</a> (const char *const fileName, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Open a named file to write. <a href="#5939d893ef7399d9d770be562bea6cfb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static FileHandle&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#6e96c30edcbe8b1fa570fe2de0d5c31b">openFileToWrite</a> (const XMLCh *const fileName, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Open a named file to write. <a href="#6e96c30edcbe8b1fa570fe2de0d5c31b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static FileHandle&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#627be718689157e44f73da8fd23ee004">openStdInHandle</a> (<a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Opens the standard input as a file. <a href="#627be718689157e44f73da8fd23ee004"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#e1ee66ba01ac5b33518d86aeec9e53f8">readFileBuffer</a> (FileHandle theFile, const unsigned int toRead, <a class="el" href="XercesDefs_8hpp.html#7470c7a32c59355685ebcd878a33f126">XMLByte</a> *const toFill, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Reads the file buffer. <a href="#e1ee66ba01ac5b33518d86aeec9e53f8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#def2727424ff236cc3e70a80874a636d">writeBufferToFile</a> (FileHandle const theFile, long toWrite, const <a class="el" href="XercesDefs_8hpp.html#7470c7a32c59355685ebcd878a33f126">XMLByte</a> *const toFlush, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Writes the buffer to the file. <a href="#def2727424ff236cc3e70a80874a636d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#3e64b2526936ae010a69cb42ba44c5c8">resetFile</a> (FileHandle theFile, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Resets the file handle. <a href="#3e64b2526936ae010a69cb42ba44c5c8"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">File System Methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#41d767f41350edd2bd8853714b9124d8">getFullPath</a> (const XMLCh *const srcPath, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets the full path from a relative path. <a href="#41d767f41350edd2bd8853714b9124d8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#8385708fc8ef23f163a09f19d378231c">getCurrentDirectory</a> (<a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets the current working directory. <a href="#8385708fc8ef23f163a09f19d378231c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#381a005feb529e59f65a4cbd5fe39c11">isAnySlash</a> (XMLCh c)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Check if a charater is a slash. <a href="#381a005feb529e59f65a4cbd5fe39c11"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#ff1af43494b60e1783124747f291b6a0">removeDotSlash</a> (XMLCh *const srcPath, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Remove occurences of the pair of dot slash. <a href="#ff1af43494b60e1783124747f291b6a0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#1b90b8d2129bdcdfa4bf615db8dd85a7">removeDotDotSlash</a> (XMLCh *const srcPath, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Remove occurences of the dot dot slash. <a href="#1b90b8d2129bdcdfa4bf615db8dd85a7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#8c865f3209cf6e05712c0d1ba7d3e589">isRelative</a> (const XMLCh *const toCheck, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Determines if a path is relative or absolute. <a href="#8c865f3209cf6e05712c0d1ba7d3e589"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static XMLCh *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#e5773fab0f689e5befc627d515818d46">weavePaths</a> (const XMLCh *const basePath, const XMLCh *const relativePath, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Utility to join two paths. <a href="#e5773fab0f689e5befc627d515818d46"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Timing Methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static unsigned long&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#4d315cfa7b9ec38b47b458fde5f2f443">getCurrentMillis</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets the system time in milliseconds. <a href="#4d315cfa7b9ec38b47b458fde5f2f443"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Mutex Methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#93f00210c7457053c0c36bf1670d11ce">closeMutex</a> (void *const mtxHandle)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Closes a mutex handle. <a href="#93f00210c7457053c0c36bf1670d11ce"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#15fd7d673d0c6ce193b5c068d0c4b872">lockMutex</a> (void *const mtxHandle)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Locks a mutex handle. <a href="#15fd7d673d0c6ce193b5c068d0c4b872"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#ac9e4850cf8f915d90825d959889b6e1">makeMutex</a> (<a class="el" href="classMemoryManager.html">MemoryManager</a> *manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Make a new mutex. <a href="#ac9e4850cf8f915d90825d959889b6e1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#e0213591d1ba763a82bd25197e22a89b">unlockMutex</a> (void *const mtxHandle)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Unlocks a mutex. <a href="#e0213591d1ba763a82bd25197e22a89b"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">External Message Support</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static XMLMsgLoader *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#f1981b8cfbf3b2d13e2debfd1eac634e">loadMsgSet</a> (const XMLCh *const msgDomain)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Loads the message set from among the available domains. <a href="#f1981b8cfbf3b2d13e2debfd1eac634e"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Miscellaneous synchronization methods</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#741d3da2b120984f615a2823355d9543">compareAndSwap</a> (void **toFill, const void *const newValue, const void *const toCompare)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Conditionally updates or returns a single word variable atomically. <a href="#741d3da2b120984f615a2823355d9543"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Atomic Increment and Decrement</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#51faf3aae265fd8f3ad9dd7245a760db">atomicIncrement</a> (int &amp;location)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Increments a single word variable atomically. <a href="#51faf3aae265fd8f3ad9dd7245a760db"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#c93b09b2954940d1c1cb4a3f4f15c6d2">atomicDecrement</a> (int &amp;location)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Decrements a single word variable atomically. <a href="#c93b09b2954940d1c1cb4a3f4f15c6d2"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">NEL Character Handling</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#92246fafe4d841516c48b88f10d62a4a">recognizeNEL</a> (bool state, <a class="el" href="classMemoryManager.html">MemoryManager</a> *const manager=<a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a>)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This function enables the recognition of NEL(0x85) char and LSEP (0x2028) as newline chars which is disabled by default. <a href="#92246fafe4d841516c48b88f10d62a4a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#4367daf991397024b918fb0ab1a0389d">isNELRecognized</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Return the value of fgNEL flag. <a href="#4367daf991397024b918fb0ab1a0389d"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Strict IANA Encoding Checking</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#467744b197025769630c61e940336434">strictIANAEncoding</a> (const bool state)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This function enables/disables strict IANA encoding names checking. <a href="#467744b197025769630c61e940336434"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#996f16ad1aad195eb2e7e618b5f89f94">isStrictIANAEncoding</a> ()</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Returns whether a strict IANA encoding name check is enabled or disabled. <a href="#996f16ad1aad195eb2e7e618b5f89f94"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Static Public Attributes</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Public Static Data</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classXMLNetAccessor.html">XMLNetAccessor</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#6bbba118a3327b2e7c1952bf04de2787">fgNetAccessor</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The network accessor. <a href="#6bbba118a3327b2e7c1952bf04de2787"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classXMLTransService.html">XMLTransService</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#bb0ad83db922cbf891a70319b2e6702b">fgTransService</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The transcoding service. <a href="#bb0ad83db922cbf891a70319b2e6702b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classPanicHandler.html">PanicHandler</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#ac6484e7073d5fb515ea791ee873b5bd">fgUserPanicHandler</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The Panic Handler. <a href="#ac6484e7073d5fb515ea791ee873b5bd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classPanicHandler.html">PanicHandler</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#db96471b53887380718f80e54934925f">fgDefaultPanicHandler</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The Panic Handler. <a href="#db96471b53887380718f80e54934925f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classMemoryManager.html">MemoryManager</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">fgMemoryManager</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The configurable memory manager. <a href="#97eff0d9fff3567bea3acd3ca4d95252"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classMemoryManager.html">MemoryManager</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#8d48adb3e9ebe23f1760709006632283">fgArrayMemoryManager</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The array-allocating memory manager. <a href="#8d48adb3e9ebe23f1760709006632283"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static XMLMutex *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classXMLPlatformUtils.html#aa3859ca77bec01d7c5c4da4632ab761">fgAtomicMutex</a></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Utilities that must be implemented in a platform-specific way.
<p>
This class contains methods that must be implemented in a platform specific manner. The actual implementations of these methods are available in the per-platform files indide <code>src/util/Platforms </code>. <hr><h2>Member Function Documentation</h2>
<a class="anchor" name="378a0935e1d80c64b7a53dc35baad8f6"></a><!-- doxytag: member="XMLPlatformUtils::Initialize" ref="378a0935e1d80c64b7a53dc35baad8f6" args="(const char *const locale=XMLUni::fgXercescDefaultLocale, const char *const nlsHome=0, PanicHandler *const panicHandler=0, MemoryManager *const memoryManager=0, bool toInitStatics=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::Initialize </td>
<td>(</td>
<td class="paramtype">const char *const &nbsp;</td>
<td class="paramname"> <em>locale</em> = <code><a class="el" href="classXMLUni.html#65fb61efef197f1387836a339477ab5e">XMLUni::fgXercescDefaultLocale</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *const &nbsp;</td>
<td class="paramname"> <em>nlsHome</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classPanicHandler.html">PanicHandler</a> *const &nbsp;</td>
<td class="paramname"> <em>panicHandler</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>memoryManager</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"> <em>toInitStatics</em> = <code>false</code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Perform per-process parser initialization.
<p>
Initialization <b>must</b> be called first in any client code.<p>
The locale is set iff the <a class="el" href="classXMLPlatformUtils.html#378a0935e1d80c64b7a53dc35baad8f6" title="Perform per-process parser initialization.">Initialize()</a> is invoked for the very first time, to ensure that each and every message loaders, in the process space, share the same locale.<p>
All subsequent invocations of <a class="el" href="classXMLPlatformUtils.html#378a0935e1d80c64b7a53dc35baad8f6" title="Perform per-process parser initialization.">Initialize()</a>, with a different locale, have no effect on the message loaders, either instantiated, or to be instantiated.<p>
To set to a different locale, client application needs to <a class="el" href="classXMLPlatformUtils.html#dc0dcc57907126e06a2f5e376b392794" title="Perform per-process parser termination.">Terminate()</a> (or multiple <a class="el" href="classXMLPlatformUtils.html#dc0dcc57907126e06a2f5e376b392794" title="Perform per-process parser termination.">Terminate()</a> in the case where multiple <a class="el" href="classXMLPlatformUtils.html#378a0935e1d80c64b7a53dc35baad8f6" title="Perform per-process parser initialization.">Initialize()</a> have been invoked before), followed by Initialize(new_locale).<p>
The default locale is "en_US".<p>
nlsHome: user specified location where MsgLoader retrieves error message files. the discussion above with regard to locale, applies to this nlsHome as well.<p>
panicHandler: application's panic handler, application owns this handler. Application shall make sure that the plugged panic handler persists through the call to XMLPlatformUtils::terminate().<p>
memoryManager: plugged-in memory manager which is owned by user applications. Applications must make sure that the plugged-in memory manager persist through the call to XMLPlatformUtils::terminate()
</div>
</div><p>
<a class="anchor" name="dc0dcc57907126e06a2f5e376b392794"></a><!-- doxytag: member="XMLPlatformUtils::Terminate" ref="dc0dcc57907126e06a2f5e376b392794" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::Terminate </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Perform per-process parser termination.
<p>
The termination call is currently optional, to aid those dynamically loading the parser to clean up before exit, or to avoid spurious reports from leak detectors.
</div>
</div><p>
<a class="anchor" name="b07bdc9abed13b76519c88b166cd6442"></a><!-- doxytag: member="XMLPlatformUtils::panic" ref="b07bdc9abed13b76519c88b166cd6442" args="(const PanicHandler::PanicReasons reason)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::panic </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPanicHandler.html#ace4c4f408d68f168e1c2537e0ba5be2">PanicHandler::PanicReasons</a>&nbsp;</td>
<td class="paramname"> <em>reason</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The panic mechanism.
<p>
If, during initialization, we cannot even get far enough along to get transcoding up or get message loading working, we call this method.<p>
Each platform can implement it however they want. This method will delegate the panic handling to a user specified panic handler or in the absence of it, the default panic handler.<p>
In case the default panic handler does not support a particular platform, the platform specific panic hanlding shall be implemented here .<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>reason</em>&nbsp;</td><td>The enumeration that defines the cause of the failure </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="8c57d8d9cb96dc7b49aeca2db5f438eb"></a><!-- doxytag: member="XMLPlatformUtils::curFilePos" ref="8c57d8d9cb96dc7b49aeca2db5f438eb" args="(FileHandle theFile, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static unsigned int XMLPlatformUtils::curFilePos </td>
<td>(</td>
<td class="paramtype">FileHandle&nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the current file position.
<p>
This must be implemented by the per-platform driver, which should use local file services to deterine the current position within the passed file.<p>
Since the file API provided here only reads, if the host platform supports separate read/write positions, only the read position is of any interest, and hence should be the one returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="a0398de86ccca867efb18f73ec8a82f4"></a><!-- doxytag: member="XMLPlatformUtils::closeFile" ref="a0398de86ccca867efb18f73ec8a82f4" args="(FileHandle theFile, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::closeFile </td>
<td>(</td>
<td class="paramtype">FileHandle&nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Closes the file handle.
<p>
This must be implemented by the per-platform driver, which should use local file services to close the passed file handle, and to destroy the passed file handle and any allocated data or system resources it contains.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle to close </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="6a5d50b2d88d4368e71325e65dfc5342"></a><!-- doxytag: member="XMLPlatformUtils::fileSize" ref="6a5d50b2d88d4368e71325e65dfc5342" args="(FileHandle theFile, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static unsigned int XMLPlatformUtils::fileSize </td>
<td>(</td>
<td class="paramtype">FileHandle&nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the file size.
<p>
This must be implemented by the per-platform driver, which should use local file services to determine the current size of the file represented by the passed handle.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle whose size you want </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the size of the file in bytes </dd></dl>
</div>
</div><p>
<a class="anchor" name="98eadae95169c66853c8264438505907"></a><!-- doxytag: member="XMLPlatformUtils::openFile" ref="98eadae95169c66853c8264438505907" args="(const char *const fileName, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static FileHandle XMLPlatformUtils::openFile </td>
<td>(</td>
<td class="paramtype">const char *const &nbsp;</td>
<td class="paramname"> <em>fileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Opens the file.
<p>
This must be implemented by the per-platform driver, which should use local file services to open passed file. If it fails, a null handle pointer should be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fileName</em>&nbsp;</td><td>The string containing the name of the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle of the opened file </dd></dl>
</div>
</div><p>
<a class="anchor" name="5632167e9027b6def671ed4571ccf0bf"></a><!-- doxytag: member="XMLPlatformUtils::openFile" ref="5632167e9027b6def671ed4571ccf0bf" args="(const XMLCh *const fileName, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static FileHandle XMLPlatformUtils::openFile </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>fileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Opens a named file.
<p>
This must be implemented by the per-platform driver, which should use local file services to open the passed file. If it fails, a null handle pointer should be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fileName</em>&nbsp;</td><td>The string containing the name of the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle of the opened file </dd></dl>
</div>
</div><p>
<a class="anchor" name="5939d893ef7399d9d770be562bea6cfb"></a><!-- doxytag: member="XMLPlatformUtils::openFileToWrite" ref="5939d893ef7399d9d770be562bea6cfb" args="(const char *const fileName, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static FileHandle XMLPlatformUtils::openFileToWrite </td>
<td>(</td>
<td class="paramtype">const char *const &nbsp;</td>
<td class="paramname"> <em>fileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Open a named file to write.
<p>
This must be implemented by the per-platform driver, which should use local file services to open passed file. If it fails, a null handle pointer should be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fileName</em>&nbsp;</td><td>The string containing the name of the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle of the opened file </dd></dl>
</div>
</div><p>
<a class="anchor" name="6e96c30edcbe8b1fa570fe2de0d5c31b"></a><!-- doxytag: member="XMLPlatformUtils::openFileToWrite" ref="6e96c30edcbe8b1fa570fe2de0d5c31b" args="(const XMLCh *const fileName, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static FileHandle XMLPlatformUtils::openFileToWrite </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>fileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Open a named file to write.
<p>
This must be implemented by the per-platform driver, which should use local file services to open the passed file. If it fails, a null handle pointer should be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>fileName</em>&nbsp;</td><td>The string containing the name of the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle of the opened file </dd></dl>
</div>
</div><p>
<a class="anchor" name="627be718689157e44f73da8fd23ee004"></a><!-- doxytag: member="XMLPlatformUtils::openStdInHandle" ref="627be718689157e44f73da8fd23ee004" args="(MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static FileHandle XMLPlatformUtils::openStdInHandle </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Opens the standard input as a file.
<p>
This must be implemented by the per-platform driver, which should use local file services to open a handle to the standard input. It should be a copy of the standard input handle, since it will be closed later!<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle of the standard input stream </dd></dl>
</div>
</div><p>
<a class="anchor" name="e1ee66ba01ac5b33518d86aeec9e53f8"></a><!-- doxytag: member="XMLPlatformUtils::readFileBuffer" ref="e1ee66ba01ac5b33518d86aeec9e53f8" args="(FileHandle theFile, const unsigned int toRead, XMLByte *const toFill, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static unsigned int XMLPlatformUtils::readFileBuffer </td>
<td>(</td>
<td class="paramtype">FileHandle&nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const unsigned int&nbsp;</td>
<td class="paramname"> <em>toRead</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="XercesDefs_8hpp.html#7470c7a32c59355685ebcd878a33f126">XMLByte</a> *const &nbsp;</td>
<td class="paramname"> <em>toFill</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Reads the file buffer.
<p>
This must be implemented by the per-platform driver, which should use local file services to read up to 'toRead' bytes of data from the passed file, and return those bytes in the 'toFill' buffer. It is not an error not to read the requested number of bytes. When the end of file is reached, zero should be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle to be read from. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toRead</em>&nbsp;</td><td>The maximum number of byte to read from the current position </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toFill</em>&nbsp;</td><td>The byte buffer to fill </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the number of bytes read from the stream or file </dd></dl>
</div>
</div><p>
<a class="anchor" name="def2727424ff236cc3e70a80874a636d"></a><!-- doxytag: member="XMLPlatformUtils::writeBufferToFile" ref="def2727424ff236cc3e70a80874a636d" args="(FileHandle const theFile, long toWrite, const XMLByte *const toFlush, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::writeBufferToFile </td>
<td>(</td>
<td class="paramtype">FileHandle const &nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">long&nbsp;</td>
<td class="paramname"> <em>toWrite</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="XercesDefs_8hpp.html#7470c7a32c59355685ebcd878a33f126">XMLByte</a> *const &nbsp;</td>
<td class="paramname"> <em>toFlush</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Writes the buffer to the file.
<p>
This must be implemented by the per-platform driver, which should use local file services to write up to 'toWrite' bytes of data to the passed file. Unless exception raised by local file services, 'toWrite' bytes of data is to be written to the passed file.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle to be written to. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toWrite</em>&nbsp;</td><td>The maximum number of byte to write from the current position </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toFlush</em>&nbsp;</td><td>The byte buffer to flush </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>void </dd></dl>
</div>
</div><p>
<a class="anchor" name="3e64b2526936ae010a69cb42ba44c5c8"></a><!-- doxytag: member="XMLPlatformUtils::resetFile" ref="3e64b2526936ae010a69cb42ba44c5c8" args="(FileHandle theFile, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::resetFile </td>
<td>(</td>
<td class="paramtype">FileHandle&nbsp;</td>
<td class="paramname"> <em>theFile</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Resets the file handle.
<p>
This must be implemented by the per-platform driver which will use local file services to reset the file position to the start of the the file.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theFile</em>&nbsp;</td><td>The file handle that you want to reset </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="41d767f41350edd2bd8853714b9124d8"></a><!-- doxytag: member="XMLPlatformUtils::getFullPath" ref="41d767f41350edd2bd8853714b9124d8" args="(const XMLCh *const srcPath, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static XMLCh* XMLPlatformUtils::getFullPath </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>srcPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the full path from a relative path.
<p>
This must be implemented by the per-platform driver. It should complete a relative path using the 'current directory', or whatever the local equivalent of a current directory is. If the passed source path is actually fully qualified, then a straight copy of it will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>srcPath</em>&nbsp;</td><td>The path of the file for which you want the full path</td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>Pointer to the memory manager to be used to allocate objects.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the fully qualified path of the file name including the file name. This is dyanmically allocated and must be deleted by the caller when its no longer needed! The memory returned will beallocated using the static memory manager, if user do not supply a memory manager. Users then need to make sure to use either the default or user specific memory manager to deallocate the memory. </dd></dl>
</div>
</div><p>
<a class="anchor" name="8385708fc8ef23f163a09f19d378231c"></a><!-- doxytag: member="XMLPlatformUtils::getCurrentDirectory" ref="8385708fc8ef23f163a09f19d378231c" args="(MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static XMLCh* XMLPlatformUtils::getCurrentDirectory </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the current working directory.
<p>
This must be implemented by the per-platform driver. It returns the current working directory is. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the current working directory. This is dyanmically allocated and must be deleted by the caller when its no longer needed! The memory returned will be allocated using the static memory manager, if users do not supply a memory manager. Users then need to make sure to use either the default or user specific memory manager to deallocate the memory. </dd></dl>
</div>
</div><p>
<a class="anchor" name="381a005feb529e59f65a4cbd5fe39c11"></a><!-- doxytag: member="XMLPlatformUtils::isAnySlash" ref="381a005feb529e59f65a4cbd5fe39c11" args="(XMLCh c)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool XMLPlatformUtils::isAnySlash </td>
<td>(</td>
<td class="paramtype">XMLCh&nbsp;</td>
<td class="paramname"> <em>c</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Check if a charater is a slash.
<p>
This must be implemented by the per-platform driver.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em>&nbsp;</td><td>the character to be examined</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the character examined is a slash false otherwise </dd></dl>
</div>
</div><p>
<a class="anchor" name="ff1af43494b60e1783124747f291b6a0"></a><!-- doxytag: member="XMLPlatformUtils::removeDotSlash" ref="ff1af43494b60e1783124747f291b6a0" args="(XMLCh *const srcPath, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::removeDotSlash </td>
<td>(</td>
<td class="paramtype">XMLCh *const &nbsp;</td>
<td class="paramname"> <em>srcPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove occurences of the pair of dot slash.
<p>
To remove the sequence, dot slash if it is part of the sequence, slash dot slash.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>srcPath</em>&nbsp;</td><td>The path for which you want to remove the dot slash sequence. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd></dd></dl>
</div>
</div><p>
<a class="anchor" name="1b90b8d2129bdcdfa4bf615db8dd85a7"></a><!-- doxytag: member="XMLPlatformUtils::removeDotDotSlash" ref="1b90b8d2129bdcdfa4bf615db8dd85a7" args="(XMLCh *const srcPath, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::removeDotDotSlash </td>
<td>(</td>
<td class="paramtype">XMLCh *const &nbsp;</td>
<td class="paramname"> <em>srcPath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove occurences of the dot dot slash.
<p>
To remove the sequence, slash dot dot slash and its preceding path segment if and only if the preceding path segment is not slash dot dot slash.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>srcPath</em>&nbsp;</td><td>The path for which you want to remove the slash dot dot slash sequence and its preceding path segment. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd></dd></dl>
</div>
</div><p>
<a class="anchor" name="8c865f3209cf6e05712c0d1ba7d3e589"></a><!-- doxytag: member="XMLPlatformUtils::isRelative" ref="8c865f3209cf6e05712c0d1ba7d3e589" args="(const XMLCh *const toCheck, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool XMLPlatformUtils::isRelative </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>toCheck</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Determines if a path is relative or absolute.
<p>
This must be implemented by the per-platform driver, which should determine whether the passed path is relative or not. The concept of relative and absolute might be... well relative on different platforms. But, as long as the determination is made consistently and in coordination with the <a class="el" href="classXMLPlatformUtils.html#e5773fab0f689e5befc627d515818d46" title="Utility to join two paths.">weavePaths()</a> method, it should work for any platform.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>toCheck</em>&nbsp;</td><td>The file name which you want to check </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns true if the filename appears to be relative </dd></dl>
</div>
</div><p>
<a class="anchor" name="e5773fab0f689e5befc627d515818d46"></a><!-- doxytag: member="XMLPlatformUtils::weavePaths" ref="e5773fab0f689e5befc627d515818d46" args="(const XMLCh *const basePath, const XMLCh *const relativePath, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static XMLCh* XMLPlatformUtils::weavePaths </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>basePath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>relativePath</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Utility to join two paths.
<p>
This must be implemented by the per-platform driver, and should weave the relative path part together with the base part and return a new path that represents this combination.<p>
If the relative part turns out to be fully qualified, it will be returned as is. If it is not, then it will be woven onto the passed base path, by removing one path component for each leading "../" (or whatever is the equivalent in the local system) in the relative path.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>basePath</em>&nbsp;</td><td>The string containing the base path </td></tr>
<tr><td valign="top"></td><td valign="top"><em>relativePath</em>&nbsp;</td><td>The string containing the relative path </td></tr>
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns a string containing the 'woven' path. It should be dynamically allocated and becomes the responsibility of the caller to delete. </dd></dl>
</div>
</div><p>
<a class="anchor" name="4d315cfa7b9ec38b47b458fde5f2f443"></a><!-- doxytag: member="XMLPlatformUtils::getCurrentMillis" ref="4d315cfa7b9ec38b47b458fde5f2f443" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static unsigned long XMLPlatformUtils::getCurrentMillis </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the system time in milliseconds.
<p>
This must be implemented by the per-platform driver, which should use local services to return the current value of a running millisecond timer. Note that the value returned is only as accurate as the millisecond time of the underyling host system.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the system time as an unsigned long </dd></dl>
</div>
</div><p>
<a class="anchor" name="93f00210c7457053c0c36bf1670d11ce"></a><!-- doxytag: member="XMLPlatformUtils::closeMutex" ref="93f00210c7457053c0c36bf1670d11ce" args="(void *const mtxHandle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::closeMutex </td>
<td>(</td>
<td class="paramtype">void *const &nbsp;</td>
<td class="paramname"> <em>mtxHandle</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Closes a mutex handle.
<p>
Each per-platform driver must implement this. Only it knows what the actual content of the passed mutex handle is.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mtxHandle</em>&nbsp;</td><td>The mutex handle that you want to close </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="15fd7d673d0c6ce193b5c068d0c4b872"></a><!-- doxytag: member="XMLPlatformUtils::lockMutex" ref="15fd7d673d0c6ce193b5c068d0c4b872" args="(void *const mtxHandle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::lockMutex </td>
<td>(</td>
<td class="paramtype">void *const &nbsp;</td>
<td class="paramname"> <em>mtxHandle</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Locks a mutex handle.
<p>
Each per-platform driver must implement this. Only it knows what the actual content of the passed mutex handle is.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mtxHandle</em>&nbsp;</td><td>The mutex handle that you want to lock </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ac9e4850cf8f915d90825d959889b6e1"></a><!-- doxytag: member="XMLPlatformUtils::makeMutex" ref="ac9e4850cf8f915d90825d959889b6e1" args="(MemoryManager *manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void* XMLPlatformUtils::makeMutex </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *&nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Make a new mutex.
<p>
Each per-platform driver must implement this. Only it knows what the actual content of the passed mutex handle is. The returned handle pointer will be eventually passed to <a class="el" href="classXMLPlatformUtils.html#93f00210c7457053c0c36bf1670d11ce" title="Closes a mutex handle.">closeMutex()</a> which is also implemented by the platform driver.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>manager</em>&nbsp;</td><td>The <a class="el" href="classMemoryManager.html" title="Configurable memory manager.">MemoryManager</a> to use to allocate objects </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="e0213591d1ba763a82bd25197e22a89b"></a><!-- doxytag: member="XMLPlatformUtils::unlockMutex" ref="e0213591d1ba763a82bd25197e22a89b" args="(void *const mtxHandle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::unlockMutex </td>
<td>(</td>
<td class="paramtype">void *const &nbsp;</td>
<td class="paramname"> <em>mtxHandle</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Unlocks a mutex.
<p>
Each per-platform driver must implement this. Only it knows what the actual content of the passed mutex handle is.<p>
Note that, since the underlying system synchronization services are used, Xerces cannot guarantee that lock/unlock operations are correctly enforced on a per-thread basis or that incorrect nesting of lock/unlock operations will be caught.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mtxHandle</em>&nbsp;</td><td>The mutex handle that you want to unlock </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="f1981b8cfbf3b2d13e2debfd1eac634e"></a><!-- doxytag: member="XMLPlatformUtils::loadMsgSet" ref="f1981b8cfbf3b2d13e2debfd1eac634e" args="(const XMLCh *const msgDomain)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static XMLMsgLoader* XMLPlatformUtils::loadMsgSet </td>
<td>(</td>
<td class="paramtype">const XMLCh *const &nbsp;</td>
<td class="paramname"> <em>msgDomain</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Loads the message set from among the available domains.
<p>
The returned object must be dynamically allocated and the caller becomes responsible for cleaning it up.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>msgDomain</em>&nbsp;</td><td>The message domain which you want to load </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="741d3da2b120984f615a2823355d9543"></a><!-- doxytag: member="XMLPlatformUtils::compareAndSwap" ref="741d3da2b120984f615a2823355d9543" args="(void **toFill, const void *const newValue, const void *const toCompare)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void* XMLPlatformUtils::compareAndSwap </td>
<td>(</td>
<td class="paramtype">void **&nbsp;</td>
<td class="paramname"> <em>toFill</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *const &nbsp;</td>
<td class="paramname"> <em>newValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *const &nbsp;</td>
<td class="paramname"> <em>toCompare</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Conditionally updates or returns a single word variable atomically.
<p>
This must be implemented by the per-platform driver. The compareAndSwap subroutine performs an atomic operation which compares the contents of a single word variable with a stored old value. If the values are equal, a new value is stored in the single word variable and TRUE is returned; otherwise, the old value is set to the current value of the single word variable and FALSE is returned.<p>
The compareAndSwap subroutine is useful when a word value must be updated only if it has not been changed since it was last read.<p>
Note: The word containing the single word variable must be aligned on a full word boundary.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>toFill</em>&nbsp;</td><td>Specifies the address of the single word variable </td></tr>
<tr><td valign="top"></td><td valign="top"><em>newValue</em>&nbsp;</td><td>Specifies the new value to be conditionally assigned to the single word variable. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toCompare</em>&nbsp;</td><td>Specifies the address of the old value to be checked against (and conditionally updated with) the value of the single word variable.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns the new value assigned to the single word variable </dd></dl>
</div>
</div><p>
<a class="anchor" name="51faf3aae265fd8f3ad9dd7245a760db"></a><!-- doxytag: member="XMLPlatformUtils::atomicIncrement" ref="51faf3aae265fd8f3ad9dd7245a760db" args="(int &amp;location)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int XMLPlatformUtils::atomicIncrement </td>
<td>(</td>
<td class="paramtype">int &amp;&nbsp;</td>
<td class="paramname"> <em>location</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Increments a single word variable atomically.
<p>
This must be implemented by the per-platform driver. The atomicIncrement subroutine increments one word in a single atomic operation. This operation is useful when a counter variable is shared between several threads or processes. When updating such a counter variable, it is important to make sure that the fetch, update, and store operations occur atomically (are not interruptible).<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>location</em>&nbsp;</td><td>Specifies the address of the word variable to be incremented.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The function return value is positive if the result of the operation was positive. Zero if the result of the operation was zero. Negative if the result of the operation was negative. Except for the zero case, the value returned may differ from the actual result of the operation - only the sign and zero/nonzero state is guaranteed to be correct. </dd></dl>
</div>
</div><p>
<a class="anchor" name="c93b09b2954940d1c1cb4a3f4f15c6d2"></a><!-- doxytag: member="XMLPlatformUtils::atomicDecrement" ref="c93b09b2954940d1c1cb4a3f4f15c6d2" args="(int &amp;location)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int XMLPlatformUtils::atomicDecrement </td>
<td>(</td>
<td class="paramtype">int &amp;&nbsp;</td>
<td class="paramname"> <em>location</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Decrements a single word variable atomically.
<p>
This must be implemented by the per-platform driver. The atomicDecrement subroutine increments one word in a single atomic operation. This operation is useful when a counter variable is shared between several threads or processes. When updating such a counter variable, it is important to make sure that the fetch, update, and store operations occur atomically (are not interruptible).<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>location</em>&nbsp;</td><td>Specifies the address of the word variable to be decremented.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The function return value is positive if the result of the operation was positive. Zero if the result of the operation was zero. Negative if the result of the operation was negative. Except for the zero case, the value returned may differ from the actual result of the operation - only the sign and zero/nonzero state is guaranteed to be correct. </dd></dl>
</div>
</div><p>
<a class="anchor" name="92246fafe4d841516c48b88f10d62a4a"></a><!-- doxytag: member="XMLPlatformUtils::recognizeNEL" ref="92246fafe4d841516c48b88f10d62a4a" args="(bool state, MemoryManager *const manager=XMLPlatformUtils::fgMemoryManager)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::recognizeNEL </td>
<td>(</td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"> <em>state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *const &nbsp;</td>
<td class="paramname"> <em>manager</em> = <code><a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a></code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This function enables the recognition of NEL(0x85) char and LSEP (0x2028) as newline chars which is disabled by default.
<p>
It is only called once per process. Once it is set, any subsequent calls will result in exception being thrown.<p>
Note: 1. Turning this option on will make the parser non compliant to XML 1.0. 2. This option has no effect to document conforming to XML 1.1 compliant, which always recognize these two chars (0x85 and 0x2028) as newline characters.
</div>
</div><p>
<a class="anchor" name="4367daf991397024b918fb0ab1a0389d"></a><!-- doxytag: member="XMLPlatformUtils::isNELRecognized" ref="4367daf991397024b918fb0ab1a0389d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool XMLPlatformUtils::isNELRecognized </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return the value of fgNEL flag.
<p>
</div>
</div><p>
<a class="anchor" name="467744b197025769630c61e940336434"></a><!-- doxytag: member="XMLPlatformUtils::strictIANAEncoding" ref="467744b197025769630c61e940336434" args="(const bool state)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void XMLPlatformUtils::strictIANAEncoding </td>
<td>(</td>
<td class="paramtype">const bool&nbsp;</td>
<td class="paramname"> <em>state</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This function enables/disables strict IANA encoding names checking.
<p>
The strict checking is disabled by default.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>state</em>&nbsp;</td><td>If true, a strict IANA encoding name check is performed, otherwise, no checking. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="996f16ad1aad195eb2e7e618b5f89f94"></a><!-- doxytag: member="XMLPlatformUtils::isStrictIANAEncoding" ref="996f16ad1aad195eb2e7e618b5f89f94" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool XMLPlatformUtils::isStrictIANAEncoding </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns whether a strict IANA encoding name check is enabled or disabled.
<p>
</div>
</div><p>
<a class="anchor" name="a9ebaf28b01ef8a55652ce099e6e2982"></a><!-- doxytag: member="XMLPlatformUtils::alignPointerForNewBlockAllocation" ref="a9ebaf28b01ef8a55652ce099e6e2982" args="(size_t ptrSize)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static size_t XMLPlatformUtils::alignPointerForNewBlockAllocation </td>
<td>(</td>
<td class="paramtype">size_t&nbsp;</td>
<td class="paramname"> <em>ptrSize</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Aligns the specified pointer per platform block allocation requirements.
<p>
The results of this function may be altered by defining XML_PLATFORM_NEW_BLOCK_ALIGNMENT.
</div>
</div><p>
<hr><h2>Member Data Documentation</h2>
<a class="anchor" name="6bbba118a3327b2e7c1952bf04de2787"></a><!-- doxytag: member="XMLPlatformUtils::fgNetAccessor" ref="6bbba118a3327b2e7c1952bf04de2787" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXMLNetAccessor.html">XMLNetAccessor</a>* <a class="el" href="classXMLPlatformUtils.html#6bbba118a3327b2e7c1952bf04de2787">XMLPlatformUtils::fgNetAccessor</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The network accessor.
<p>
This is provided by the per-platform driver, so each platform can choose what actual implementation it wants to use. The object must be dynamically allocated.<p>
<em>Note that you may optionally, if your platform driver does not install a network accessor, set it manually from your client code after calling <a class="el" href="classXMLPlatformUtils.html#378a0935e1d80c64b7a53dc35baad8f6" title="Perform per-process parser initialization.">Initialize()</a>. This works because this object is not required during initialization, and only comes into play during actual XML parsing.</em>
</div>
</div><p>
<a class="anchor" name="bb0ad83db922cbf891a70319b2e6702b"></a><!-- doxytag: member="XMLPlatformUtils::fgTransService" ref="bb0ad83db922cbf891a70319b2e6702b" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXMLTransService.html">XMLTransService</a>* <a class="el" href="classXMLPlatformUtils.html#bb0ad83db922cbf891a70319b2e6702b">XMLPlatformUtils::fgTransService</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The transcoding service.
<p>
This is provided by the per platform driver, so each platform can choose what implemenation it wants to use. When the platform independent initialization code needs to get a transcoding service object, it will call <code>makeTransService()</code> to ask the per-platform code to create one. Only one transcoding service object is reqeusted per-process, so it is shared and synchronized among parser instances within that process.
</div>
</div><p>
<a class="anchor" name="ac6484e7073d5fb515ea791ee873b5bd"></a><!-- doxytag: member="XMLPlatformUtils::fgUserPanicHandler" ref="ac6484e7073d5fb515ea791ee873b5bd" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPanicHandler.html">PanicHandler</a>* <a class="el" href="classXMLPlatformUtils.html#ac6484e7073d5fb515ea791ee873b5bd">XMLPlatformUtils::fgUserPanicHandler</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The Panic Handler.
<p>
This is the application provided panic handler.
</div>
</div><p>
<a class="anchor" name="db96471b53887380718f80e54934925f"></a><!-- doxytag: member="XMLPlatformUtils::fgDefaultPanicHandler" ref="db96471b53887380718f80e54934925f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPanicHandler.html">PanicHandler</a>* <a class="el" href="classXMLPlatformUtils.html#db96471b53887380718f80e54934925f">XMLPlatformUtils::fgDefaultPanicHandler</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The Panic Handler.
<p>
This is the default panic handler.
</div>
</div><p>
<a class="anchor" name="97eff0d9fff3567bea3acd3ca4d95252"></a><!-- doxytag: member="XMLPlatformUtils::fgMemoryManager" ref="97eff0d9fff3567bea3acd3ca4d95252" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classMemoryManager.html">MemoryManager</a>* <a class="el" href="classXMLPlatformUtils.html#97eff0d9fff3567bea3acd3ca4d95252">XMLPlatformUtils::fgMemoryManager</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The configurable memory manager.
<p>
This is the pluggable memory manager. If it is not provided by an application, a default implementation is used.
</div>
</div><p>
<a class="anchor" name="8d48adb3e9ebe23f1760709006632283"></a><!-- doxytag: member="XMLPlatformUtils::fgArrayMemoryManager" ref="8d48adb3e9ebe23f1760709006632283" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classMemoryManager.html">MemoryManager</a>* <a class="el" href="classXMLPlatformUtils.html#8d48adb3e9ebe23f1760709006632283">XMLPlatformUtils::fgArrayMemoryManager</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The array-allocating memory manager.
<p>
This memory manager always allocates memory by calling the global new[] operator. It may be used to allocate memory where such memory needs to be deletable by calling delete []. Since this allocator is always guaranteed to do the same thing there is no reason, nor facility, to override it.
</div>
</div><p>
<a class="anchor" name="aa3859ca77bec01d7c5c4da4632ab761"></a><!-- doxytag: member="XMLPlatformUtils::fgAtomicMutex" ref="aa3859ca77bec01d7c5c4da4632ab761" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">XMLMutex* <a class="el" href="classXMLPlatformUtils.html#aa3859ca77bec01d7c5c4da4632ab761">XMLPlatformUtils::fgAtomicMutex</a><code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="PlatformUtils_8hpp-source.html">PlatformUtils.hpp</a></ul>
</FONT></TD></TR></TABLE><BR>
</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>
Copyright &copy; 1994-2004 The Apache Software Foundation.
All Rights Reserved.
</I></FONT></TD></TR></TABLE></BODY></HTML>