You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

251 lines
14 KiB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.8.9.1"/>
  7. <title>Xerces-C++: Locator Class Reference</title>
  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  9. <script type="text/javascript" src="jquery.js"></script>
  10. <script type="text/javascript" src="dynsections.js"></script>
  11. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  12. </head>
  13. <body>
  14. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  15. <div id="titlearea">
  16. <table cellspacing="0" cellpadding="0">
  17. <tbody>
  18. <tr style="height: 56px;">
  19. <td style="padding-left: 0.5em;">
  20. <div id="projectname">Xerces-C++
  21. &#160;<span id="projectnumber">3.1.2</span>
  22. </div>
  23. </td>
  24. </tr>
  25. </tbody>
  26. </table>
  27. </div>
  28. <!-- end header part -->
  29. <!-- Generated by Doxygen 1.8.9.1 -->
  30. <div id="navrow1" class="tabs">
  31. <ul class="tablist">
  32. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  33. <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
  34. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  35. <li><a href="files.html"><span>Files</span></a></li>
  36. </ul>
  37. </div>
  38. <div id="navrow2" class="tabs2">
  39. <ul class="tablist">
  40. <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  41. <li><a href="classes.html"><span>Class&#160;Index</span></a></li>
  42. <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
  43. <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  44. </ul>
  45. </div>
  46. </div><!-- top -->
  47. <div class="header">
  48. <div class="summary">
  49. <a href="classLocator-members.html">List of all members</a> </div>
  50. <div class="headertitle">
  51. <div class="title">Locator Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div>
  52. </div><!--header-->
  53. <div class="contents">
  54. <p>Interface for associating a SAX event with a document location.
  55. <a href="classLocator.html#details">More...</a></p>
  56. <table class="memberdecls">
  57. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  58. Public Member Functions</h2></td></tr>
  59. <tr><td colspan="2"><div class="groupHeader">Constructors and Destructor</div></td></tr>
  60. <tr class="memitem:a309b4d4180297ebe1a15c3ddff22bb0a"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#a309b4d4180297ebe1a15c3ddff22bb0a">Locator</a> ()</td></tr>
  61. <tr class="memdesc:a309b4d4180297ebe1a15c3ddff22bb0a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Default constructor. <a href="#a309b4d4180297ebe1a15c3ddff22bb0a">More...</a><br /></td></tr>
  62. <tr class="separator:a309b4d4180297ebe1a15c3ddff22bb0a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  63. <tr class="memitem:a2b86f0347dfe72c99a97c73f3f1be6d9"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#a2b86f0347dfe72c99a97c73f3f1be6d9">~Locator</a> ()</td></tr>
  64. <tr class="memdesc:a2b86f0347dfe72c99a97c73f3f1be6d9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Destructor. <a href="#a2b86f0347dfe72c99a97c73f3f1be6d9">More...</a><br /></td></tr>
  65. <tr class="separator:a2b86f0347dfe72c99a97c73f3f1be6d9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  66. <tr><td colspan="2"><div class="groupHeader">The locator interface</div></td></tr>
  67. <tr class="memitem:a907679d51b2c8b606a29a09dd0b234ac"><td class="memItemLeft" align="right" valign="top">virtual const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#a907679d51b2c8b606a29a09dd0b234ac">getPublicId</a> () const =0</td></tr>
  68. <tr class="memdesc:a907679d51b2c8b606a29a09dd0b234ac"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the public identifier for the current document event. <a href="#a907679d51b2c8b606a29a09dd0b234ac">More...</a><br /></td></tr>
  69. <tr class="separator:a907679d51b2c8b606a29a09dd0b234ac"><td class="memSeparator" colspan="2">&#160;</td></tr>
  70. <tr class="memitem:aa9c43733fdf27000a867c3824f8ed5c5"><td class="memItemLeft" align="right" valign="top">virtual const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#aa9c43733fdf27000a867c3824f8ed5c5">getSystemId</a> () const =0</td></tr>
  71. <tr class="memdesc:aa9c43733fdf27000a867c3824f8ed5c5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the system identifier for the current document event. <a href="#aa9c43733fdf27000a867c3824f8ed5c5">More...</a><br /></td></tr>
  72. <tr class="separator:aa9c43733fdf27000a867c3824f8ed5c5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  73. <tr class="memitem:a21de511fbb12c1f350e46fc5f94a3b3c"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#add2d542a6583db767febf57446daa50d">XMLFileLoc</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#a21de511fbb12c1f350e46fc5f94a3b3c">getLineNumber</a> () const =0</td></tr>
  74. <tr class="memdesc:a21de511fbb12c1f350e46fc5f94a3b3c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the line number where the current document event ends. <a href="#a21de511fbb12c1f350e46fc5f94a3b3c">More...</a><br /></td></tr>
  75. <tr class="separator:a21de511fbb12c1f350e46fc5f94a3b3c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  76. <tr class="memitem:a434ba9538b12253da622a906c7c4566e"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#add2d542a6583db767febf57446daa50d">XMLFileLoc</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classLocator.html#a434ba9538b12253da622a906c7c4566e">getColumnNumber</a> () const =0</td></tr>
  77. <tr class="memdesc:a434ba9538b12253da622a906c7c4566e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the column number where the current document event ends. <a href="#a434ba9538b12253da622a906c7c4566e">More...</a><br /></td></tr>
  78. <tr class="separator:a434ba9538b12253da622a906c7c4566e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  79. </table>
  80. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  81. <div class="textblock"><p>Interface for associating a SAX event with a document location. </p>
  82. <p>If a SAX parser provides location information to the SAX application, it does so by implementing this interface and then passing an instance to the application using the document handler's setDocumentLocator method. The application can use the object to obtain the location of any other document handler event in the XML source document.</p>
  83. <p>Note that the results returned by the object will be valid only during the scope of each document handler method: the application will receive unpredictable results if it attempts to use the locator at any other time.</p>
  84. <p>SAX parsers are not required to supply a locator, but they are very strong encouraged to do so. If the parser supplies a locator, it must do so before reporting any other document events. If no locator has been set by the time the application receives the startDocument event, the application should assume that a locator is not available.</p>
  85. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDocumentHandler.html#ad9e42f7996fc226800c2e445f32f4f6c" title="Receive an object for locating the origin of SAX document events. ">DocumentHandler::setDocumentLocator</a> </dd></dl>
  86. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  87. <a class="anchor" id="a309b4d4180297ebe1a15c3ddff22bb0a"></a>
  88. <div class="memitem">
  89. <div class="memproto">
  90. <table class="memname">
  91. <tr>
  92. <td class="memname">Locator::Locator </td>
  93. <td>(</td>
  94. <td class="paramname"></td><td>)</td>
  95. <td></td>
  96. </tr>
  97. </table>
  98. </div><div class="memdoc">
  99. <p>Default constructor. </p>
  100. </div>
  101. </div>
  102. <a class="anchor" id="a2b86f0347dfe72c99a97c73f3f1be6d9"></a>
  103. <div class="memitem">
  104. <div class="memproto">
  105. <table class="mlabels">
  106. <tr>
  107. <td class="mlabels-left">
  108. <table class="memname">
  109. <tr>
  110. <td class="memname">virtual Locator::~Locator </td>
  111. <td>(</td>
  112. <td class="paramname"></td><td>)</td>
  113. <td></td>
  114. </tr>
  115. </table>
  116. </td>
  117. <td class="mlabels-right">
  118. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  119. </tr>
  120. </table>
  121. </div><div class="memdoc">
  122. <p>Destructor. </p>
  123. </div>
  124. </div>
  125. <h2 class="groupheader">Member Function Documentation</h2>
  126. <a class="anchor" id="a434ba9538b12253da622a906c7c4566e"></a>
  127. <div class="memitem">
  128. <div class="memproto">
  129. <table class="mlabels">
  130. <tr>
  131. <td class="mlabels-left">
  132. <table class="memname">
  133. <tr>
  134. <td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#add2d542a6583db767febf57446daa50d">XMLFileLoc</a> Locator::getColumnNumber </td>
  135. <td>(</td>
  136. <td class="paramname"></td><td>)</td>
  137. <td> const</td>
  138. </tr>
  139. </table>
  140. </td>
  141. <td class="mlabels-right">
  142. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  143. </tr>
  144. </table>
  145. </div><div class="memdoc">
  146. <p>Return the column number where the current document event ends. </p>
  147. <p>Note that this is the column number of the first character after the text associated with the document event. The first column in a line is position 1. </p><dl class="section return"><dt>Returns</dt><dd>The column number, or 0 if none is available. </dd></dl>
  148. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classLocator.html#a21de511fbb12c1f350e46fc5f94a3b3c" title="Return the line number where the current document event ends. ">getLineNumber</a> </dd></dl>
  149. </div>
  150. </div>
  151. <a class="anchor" id="a21de511fbb12c1f350e46fc5f94a3b3c"></a>
  152. <div class="memitem">
  153. <div class="memproto">
  154. <table class="mlabels">
  155. <tr>
  156. <td class="mlabels-left">
  157. <table class="memname">
  158. <tr>
  159. <td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#add2d542a6583db767febf57446daa50d">XMLFileLoc</a> Locator::getLineNumber </td>
  160. <td>(</td>
  161. <td class="paramname"></td><td>)</td>
  162. <td> const</td>
  163. </tr>
  164. </table>
  165. </td>
  166. <td class="mlabels-right">
  167. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  168. </tr>
  169. </table>
  170. </div><div class="memdoc">
  171. <p>Return the line number where the current document event ends. </p>
  172. <p>Note that this is the line position of the first character after the text associated with the document event. </p><dl class="section return"><dt>Returns</dt><dd>The line number, or 0 if none is available. </dd></dl>
  173. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classLocator.html#a434ba9538b12253da622a906c7c4566e" title="Return the column number where the current document event ends. ">getColumnNumber</a> </dd></dl>
  174. </div>
  175. </div>
  176. <a class="anchor" id="a907679d51b2c8b606a29a09dd0b234ac"></a>
  177. <div class="memitem">
  178. <div class="memproto">
  179. <table class="mlabels">
  180. <tr>
  181. <td class="mlabels-left">
  182. <table class="memname">
  183. <tr>
  184. <td class="memname">virtual const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a>* Locator::getPublicId </td>
  185. <td>(</td>
  186. <td class="paramname"></td><td>)</td>
  187. <td> const</td>
  188. </tr>
  189. </table>
  190. </td>
  191. <td class="mlabels-right">
  192. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  193. </tr>
  194. </table>
  195. </div><div class="memdoc">
  196. <p>Return the public identifier for the current document event. </p>
  197. <p>This will be the public identifier </p><dl class="section return"><dt>Returns</dt><dd>A string containing the public identifier, or null if none is available. </dd></dl>
  198. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classLocator.html#aa9c43733fdf27000a867c3824f8ed5c5" title="Return the system identifier for the current document event. ">getSystemId</a> </dd></dl>
  199. </div>
  200. </div>
  201. <a class="anchor" id="aa9c43733fdf27000a867c3824f8ed5c5"></a>
  202. <div class="memitem">
  203. <div class="memproto">
  204. <table class="mlabels">
  205. <tr>
  206. <td class="mlabels-left">
  207. <table class="memname">
  208. <tr>
  209. <td class="memname">virtual const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a>* Locator::getSystemId </td>
  210. <td>(</td>
  211. <td class="paramname"></td><td>)</td>
  212. <td> const</td>
  213. </tr>
  214. </table>
  215. </td>
  216. <td class="mlabels-right">
  217. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  218. </tr>
  219. </table>
  220. </div><div class="memdoc">
  221. <p>Return the system identifier for the current document event. </p>
  222. <p>If the system identifier is a URL, the parser must resolve it fully before passing it to the application.</p>
  223. <dl class="section return"><dt>Returns</dt><dd>A string containing the system identifier, or null if none is available. </dd></dl>
  224. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classLocator.html#a907679d51b2c8b606a29a09dd0b234ac" title="Return the public identifier for the current document event. ">getPublicId</a> </dd></dl>
  225. </div>
  226. </div>
  227. <hr/>The documentation for this class was generated from the following file:<ul>
  228. <li><a class="el" href="Locator_8hpp_source.html">Locator.hpp</a></li>
  229. </ul>
  230. </div><!-- contents -->
  231. <!-- start footer part -->
  232. <hr class="footer"/><address class="footer"><small>
  233. Generated on Wed Mar 18 2015 10:43:38 for Xerces-C++ by &#160;<a href="http://www.doxygen.org/index.html">
  234. <img class="footer" src="doxygen.png" alt="doxygen"/>
  235. </a> 1.8.9.1
  236. </small></address>
  237. </body>
  238. </html>