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.

495 lines
33 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++: DOMLSSerializer 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="classDOMLSSerializer-members.html">List of all members</a> </div>
  50. <div class="headertitle">
  51. <div class="title">DOMLSSerializer Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div>
  52. </div><!--header-->
  53. <div class="contents">
  54. <table class="memberdecls">
  55. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  56. Public Member Functions</h2></td></tr>
  57. <tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
  58. <tr class="memitem:a364cb41e681f950fba7928b4f7cca824"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a364cb41e681f950fba7928b4f7cca824">~DOMLSSerializer</a> ()</td></tr>
  59. <tr class="memdesc:a364cb41e681f950fba7928b4f7cca824"><td class="mdescLeft">&#160;</td><td class="mdescRight">Destructor. <a href="#a364cb41e681f950fba7928b4f7cca824">More...</a><br /></td></tr>
  60. <tr class="separator:a364cb41e681f950fba7928b4f7cca824"><td class="memSeparator" colspan="2">&#160;</td></tr>
  61. <tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 3</div></td></tr>
  62. <tr class="memitem:a38fe950589395527f459879563f781a4"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classDOMConfiguration.html">DOMConfiguration</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a38fe950589395527f459879563f781a4">getDomConfig</a> ()=0</td></tr>
  63. <tr class="memdesc:a38fe950589395527f459879563f781a4"><td class="mdescLeft">&#160;</td><td class="mdescRight">The <a class="el" href="classDOMConfiguration.html" title="The DOMConfiguration interface represents the configuration of a document and maintains a table of re...">DOMConfiguration</a> object used by the LSSerializer when serializing a DOM node. <a href="#a38fe950589395527f459879563f781a4">More...</a><br /></td></tr>
  64. <tr class="separator:a38fe950589395527f459879563f781a4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  65. <tr class="memitem:a56882d2fe0b4a0ecb1b3968febbcf4a3"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a56882d2fe0b4a0ecb1b3968febbcf4a3">setNewLine</a> (const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *const newLine)=0</td></tr>
  66. <tr class="memdesc:a56882d2fe0b4a0ecb1b3968febbcf4a3"><td class="mdescLeft">&#160;</td><td class="mdescRight">The end-of-line sequence of characters to be used in the XML being written out. <a href="#a56882d2fe0b4a0ecb1b3968febbcf4a3">More...</a><br /></td></tr>
  67. <tr class="separator:a56882d2fe0b4a0ecb1b3968febbcf4a3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  68. <tr class="memitem:a736dd9126411cbf26475196fd9a9b15d"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a736dd9126411cbf26475196fd9a9b15d">setFilter</a> (<a class="el" href="classDOMLSSerializerFilter.html">DOMLSSerializerFilter</a> *filter)=0</td></tr>
  69. <tr class="memdesc:a736dd9126411cbf26475196fd9a9b15d"><td class="mdescLeft">&#160;</td><td class="mdescRight">When the application provides a filter, the serializer will call out to the filter before serializing each Node. <a href="#a736dd9126411cbf26475196fd9a9b15d">More...</a><br /></td></tr>
  70. <tr class="separator:a736dd9126411cbf26475196fd9a9b15d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  71. <tr class="memitem:abece8f8c5a5e60d12c71640f502fe02c"><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="classDOMLSSerializer.html#abece8f8c5a5e60d12c71640f502fe02c">getNewLine</a> () const =0</td></tr>
  72. <tr class="memdesc:abece8f8c5a5e60d12c71640f502fe02c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the end-of-line sequence of characters to be used in the XML being written out. <a href="#abece8f8c5a5e60d12c71640f502fe02c">More...</a><br /></td></tr>
  73. <tr class="separator:abece8f8c5a5e60d12c71640f502fe02c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  74. <tr class="memitem:ac74d91ba22be19b8b8349415da5833d0"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classDOMLSSerializerFilter.html">DOMLSSerializerFilter</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#ac74d91ba22be19b8b8349415da5833d0">getFilter</a> () const =0</td></tr>
  75. <tr class="memdesc:ac74d91ba22be19b8b8349415da5833d0"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the WriterFilter used. <a href="#ac74d91ba22be19b8b8349415da5833d0">More...</a><br /></td></tr>
  76. <tr class="separator:ac74d91ba22be19b8b8349415da5833d0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  77. <tr class="memitem:a5bcb91b60535ae26ff294a2eff65af0a"><td class="memItemLeft" align="right" valign="top">virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a5bcb91b60535ae26ff294a2eff65af0a">write</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *nodeToWrite, <a class="el" href="classDOMLSOutput.html">DOMLSOutput</a> *const destination)=0</td></tr>
  78. <tr class="memdesc:a5bcb91b60535ae26ff294a2eff65af0a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Write out the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. <a href="#a5bcb91b60535ae26ff294a2eff65af0a">More...</a><br /></td></tr>
  79. <tr class="separator:a5bcb91b60535ae26ff294a2eff65af0a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  80. <tr class="memitem:a8887f89ce4b7d7d70b72f24575c8863c"><td class="memItemLeft" align="right" valign="top">virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a8887f89ce4b7d7d70b72f24575c8863c">writeToURI</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *nodeToWrite, const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *uri)=0</td></tr>
  81. <tr class="memdesc:a8887f89ce4b7d7d70b72f24575c8863c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Write out the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. <a href="#a8887f89ce4b7d7d70b72f24575c8863c">More...</a><br /></td></tr>
  82. <tr class="separator:a8887f89ce4b7d7d70b72f24575c8863c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  83. <tr class="memitem:ab4e20c70b2d3da08f350632bbf697409"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#ab4e20c70b2d3da08f350632bbf697409">writeToString</a> (const <a class="el" href="classDOMNode.html">DOMNode</a> *nodeToWrite, <a class="el" href="classMemoryManager.html">MemoryManager</a> *manager=NULL)=0</td></tr>
  84. <tr class="memdesc:ab4e20c70b2d3da08f350632bbf697409"><td class="mdescLeft">&#160;</td><td class="mdescRight">Serialize the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. <a href="#ab4e20c70b2d3da08f350632bbf697409">More...</a><br /></td></tr>
  85. <tr class="separator:ab4e20c70b2d3da08f350632bbf697409"><td class="memSeparator" colspan="2">&#160;</td></tr>
  86. <tr><td colspan="2"><div class="groupHeader">Non-standard Extension</div></td></tr>
  87. <tr class="memitem:abc804fc58e71e48715f0f0eb9348da25"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#abc804fc58e71e48715f0f0eb9348da25">release</a> ()=0</td></tr>
  88. <tr class="memdesc:abc804fc58e71e48715f0f0eb9348da25"><td class="mdescLeft">&#160;</td><td class="mdescRight">Called to indicate that this Writer is no longer in use and that the implementation may relinquish any resources associated with it. <a href="#abc804fc58e71e48715f0f0eb9348da25">More...</a><br /></td></tr>
  89. <tr class="separator:abc804fc58e71e48715f0f0eb9348da25"><td class="memSeparator" colspan="2">&#160;</td></tr>
  90. </table><table class="memberdecls">
  91. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
  92. Protected Member Functions</h2></td></tr>
  93. <tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
  94. <tr class="memitem:a1db28db26446dd9cabde4d9452a840f0"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classDOMLSSerializer.html#a1db28db26446dd9cabde4d9452a840f0">DOMLSSerializer</a> ()</td></tr>
  95. <tr class="separator:a1db28db26446dd9cabde4d9452a840f0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  96. </table>
  97. <h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  98. <a class="anchor" id="a1db28db26446dd9cabde4d9452a840f0"></a>
  99. <div class="memitem">
  100. <div class="memproto">
  101. <table class="mlabels">
  102. <tr>
  103. <td class="mlabels-left">
  104. <table class="memname">
  105. <tr>
  106. <td class="memname">DOMLSSerializer::DOMLSSerializer </td>
  107. <td>(</td>
  108. <td class="paramname"></td><td>)</td>
  109. <td></td>
  110. </tr>
  111. </table>
  112. </td>
  113. <td class="mlabels-right">
  114. <span class="mlabels"><span class="mlabel">protected</span></span> </td>
  115. </tr>
  116. </table>
  117. </div><div class="memdoc">
  118. </div>
  119. </div>
  120. <a class="anchor" id="a364cb41e681f950fba7928b4f7cca824"></a>
  121. <div class="memitem">
  122. <div class="memproto">
  123. <table class="mlabels">
  124. <tr>
  125. <td class="mlabels-left">
  126. <table class="memname">
  127. <tr>
  128. <td class="memname">virtual DOMLSSerializer::~DOMLSSerializer </td>
  129. <td>(</td>
  130. <td class="paramname"></td><td>)</td>
  131. <td></td>
  132. </tr>
  133. </table>
  134. </td>
  135. <td class="mlabels-right">
  136. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  137. </tr>
  138. </table>
  139. </div><div class="memdoc">
  140. <p>Destructor. </p>
  141. </div>
  142. </div>
  143. <h2 class="groupheader">Member Function Documentation</h2>
  144. <a class="anchor" id="a38fe950589395527f459879563f781a4"></a>
  145. <div class="memitem">
  146. <div class="memproto">
  147. <table class="mlabels">
  148. <tr>
  149. <td class="mlabels-left">
  150. <table class="memname">
  151. <tr>
  152. <td class="memname">virtual <a class="el" href="classDOMConfiguration.html">DOMConfiguration</a>* DOMLSSerializer::getDomConfig </td>
  153. <td>(</td>
  154. <td class="paramname"></td><td>)</td>
  155. <td></td>
  156. </tr>
  157. </table>
  158. </td>
  159. <td class="mlabels-right">
  160. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  161. </tr>
  162. </table>
  163. </div><div class="memdoc">
  164. <p>The <a class="el" href="classDOMConfiguration.html" title="The DOMConfiguration interface represents the configuration of a document and maintains a table of re...">DOMConfiguration</a> object used by the LSSerializer when serializing a DOM node. </p>
  165. <p>In addition to the parameters recognized in on the <code><a class="el" href="classDOMConfiguration.html" title="The DOMConfiguration interface represents the configuration of a document and maintains a table of re...">DOMConfiguration</a></code> interface defined in [DOM Level 3 Core], the <code><a class="el" href="classDOMConfiguration.html" title="The DOMConfiguration interface represents the configuration of a document and maintains a table of re...">DOMConfiguration</a></code> objects for <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code> add or modify the following parameters:</p>
  166. <p>"canonical-form" true [optional] Writes the document according to the rules specified in [Canonical XML]. In addition to the behavior described in "canonical-form" [DOM Level 3 Core], setting this parameter to true will set the parameters "format-pretty-print", "discard-default-content", and "xml-declaration", to false. Setting one of those parameters to true will set this parameter to false. Serializing an XML 1.1 document when "canonical-form" is true will generate a fatal error. false [required] (default) Do not canonicalize the output.</p>
  167. <p>"discard-default-content" true [required] (default) Use the <a class="el" href="classDOMAttr.html#abe27f82f8a21e06fea72499168f082b3" title="Returns true if the attribute received its value explicitly in the XML document, or if a value was as...">DOMAttr::getSpecified</a> attribute to decide what attributes should be discarded. Note that some implementations might use whatever information available to the implementation (i.e. XML schema, DTD, the <a class="el" href="classDOMAttr.html#abe27f82f8a21e06fea72499168f082b3" title="Returns true if the attribute received its value explicitly in the XML document, or if a value was as...">DOMAttr::getSpecified</a> attribute, and so on) to determine what attributes and content to discard if this parameter is set to true. false [required] Keep all attributes and all content.</p>
  168. <p>"format-pretty-print" true [optional] Formatting the output by adding whitespace to produce a pretty-printed, indented, human-readable form. The exact form of the transformations is not specified by this specification. Pretty-printing changes the content of the document and may affect the validity of the document, validating implementations should preserve validity. false [required] (default) Don't pretty-print the result.</p>
  169. <p>"ignore-unknown-character-denormalizations" true [required] (default) If, while verifying full normalization when [XML 1.1] is supported, a character is encountered for which the normalization properties cannot be determined, then raise a "unknown-character-denormalization" warning (instead of raising an error, if this parameter is not set) and ignore any possible denormalizations caused by these characters. false [optional] Report a fatal error if a character is encountered for which the processor cannot determine the normalization properties.</p>
  170. <p>"normalize-characters" This parameter is equivalent to the one defined by <code><a class="el" href="classDOMConfiguration.html" title="The DOMConfiguration interface represents the configuration of a document and maintains a table of re...">DOMConfiguration</a></code> in [DOM Level 3 Core]. Unlike in the Core, the default value for this parameter is true. While DOM implementations are not required to support fully normalizing the characters in the document according to appendix E of [XML 1.1], this parameter must be activated by default if supported.</p>
  171. <p>"xml-declaration" true [required] (default) If a <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document. ">DOMDocument</a>, <a class="el" href="classDOMElement.html" title="By far the vast majority of objects (apart from text) that authors encounter when traversing a docume...">DOMElement</a>, or <a class="el" href="classDOMEntity.html" title="This interface represents an entity, either parsed or unparsed, in an XML document. ">DOMEntity</a> node is serialized, the XML declaration, or text declaration, should be included. The version (DOMDocument::xmlVersion if the document is a Level 3 document and the version is non-null, otherwise use the value "1.0"), and the output encoding (see <a class="el" href="classDOMLSSerializer.html#a5bcb91b60535ae26ff294a2eff65af0a" title="Write out the specified node as described above in the description of DOMLSSerializer. ">DOMLSSerializer::write</a> for details on how to find the output encoding) are specified in the serialized XML declaration. false [required] Do not serialize the XML and text declarations. Report a "xml-declaration-needed" warning if this will cause problems (i.e. the serialized data is of an XML version other than [XML 1.0], or an encoding would be needed to be able to re-parse the serialized data).</p>
  172. <p>"error-handler" Contains a <a class="el" href="classDOMErrorHandler.html" title="Basic interface for DOM error handlers. ">DOMErrorHandler</a> object. If an error is encountered in the document, the implementation will call back the <a class="el" href="classDOMErrorHandler.html" title="Basic interface for DOM error handlers. ">DOMErrorHandler</a> registered using this parameter. The implementation may provide a default <a class="el" href="classDOMErrorHandler.html" title="Basic interface for DOM error handlers. ">DOMErrorHandler</a> object. When called, DOMError::relatedData will contain the closest node to where the error occurred. If the implementation is unable to determine the node where the error occurs, DOMError::relatedData will contain the <a class="el" href="classDOMDocument.html" title="The DOMDocument interface represents the entire XML document. ">DOMDocument</a> node. Mutations to the document from within an error handler will result in implementation dependent behavior.</p>
  173. <dl class="section return"><dt>Returns</dt><dd>The pointer to the configuration object. </dd></dl>
  174. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  175. </div>
  176. </div>
  177. <a class="anchor" id="ac74d91ba22be19b8b8349415da5833d0"></a>
  178. <div class="memitem">
  179. <div class="memproto">
  180. <table class="mlabels">
  181. <tr>
  182. <td class="mlabels-left">
  183. <table class="memname">
  184. <tr>
  185. <td class="memname">virtual <a class="el" href="classDOMLSSerializerFilter.html">DOMLSSerializerFilter</a>* DOMLSSerializer::getFilter </td>
  186. <td>(</td>
  187. <td class="paramname"></td><td>)</td>
  188. <td> const</td>
  189. </tr>
  190. </table>
  191. </td>
  192. <td class="mlabels-right">
  193. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  194. </tr>
  195. </table>
  196. </div><div class="memdoc">
  197. <p>Return the WriterFilter used. </p>
  198. <dl class="section return"><dt>Returns</dt><dd>The writer filter used. </dd></dl>
  199. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDOMLSSerializer.html#a736dd9126411cbf26475196fd9a9b15d" title="When the application provides a filter, the serializer will call out to the filter before serializing...">setFilter</a> </dd></dl>
  200. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  201. </div>
  202. </div>
  203. <a class="anchor" id="abece8f8c5a5e60d12c71640f502fe02c"></a>
  204. <div class="memitem">
  205. <div class="memproto">
  206. <table class="mlabels">
  207. <tr>
  208. <td class="mlabels-left">
  209. <table class="memname">
  210. <tr>
  211. <td class="memname">virtual const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a>* DOMLSSerializer::getNewLine </td>
  212. <td>(</td>
  213. <td class="paramname"></td><td>)</td>
  214. <td> const</td>
  215. </tr>
  216. </table>
  217. </td>
  218. <td class="mlabels-right">
  219. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  220. </tr>
  221. </table>
  222. </div><div class="memdoc">
  223. <p>Return the end-of-line sequence of characters to be used in the XML being written out. </p>
  224. <dl class="section return"><dt>Returns</dt><dd>The end-of-line sequence of characters to be used. </dd></dl>
  225. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDOMLSSerializer.html#a56882d2fe0b4a0ecb1b3968febbcf4a3" title="The end-of-line sequence of characters to be used in the XML being written out. ">setNewLine</a> </dd></dl>
  226. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  227. </div>
  228. </div>
  229. <a class="anchor" id="abc804fc58e71e48715f0f0eb9348da25"></a>
  230. <div class="memitem">
  231. <div class="memproto">
  232. <table class="mlabels">
  233. <tr>
  234. <td class="mlabels-left">
  235. <table class="memname">
  236. <tr>
  237. <td class="memname">virtual void DOMLSSerializer::release </td>
  238. <td>(</td>
  239. <td class="paramname"></td><td>)</td>
  240. <td></td>
  241. </tr>
  242. </table>
  243. </td>
  244. <td class="mlabels-right">
  245. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  246. </tr>
  247. </table>
  248. </div><div class="memdoc">
  249. <p>Called to indicate that this Writer is no longer in use and that the implementation may relinquish any resources associated with it. </p>
  250. <p>Access to a released object will lead to unexpected result. </p>
  251. </div>
  252. </div>
  253. <a class="anchor" id="a736dd9126411cbf26475196fd9a9b15d"></a>
  254. <div class="memitem">
  255. <div class="memproto">
  256. <table class="mlabels">
  257. <tr>
  258. <td class="mlabels-left">
  259. <table class="memname">
  260. <tr>
  261. <td class="memname">virtual void DOMLSSerializer::setFilter </td>
  262. <td>(</td>
  263. <td class="paramtype"><a class="el" href="classDOMLSSerializerFilter.html">DOMLSSerializerFilter</a> *&#160;</td>
  264. <td class="paramname"><em>filter</em></td><td>)</td>
  265. <td></td>
  266. </tr>
  267. </table>
  268. </td>
  269. <td class="mlabels-right">
  270. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  271. </tr>
  272. </table>
  273. </div><div class="memdoc">
  274. <p>When the application provides a filter, the serializer will call out to the filter before serializing each Node. </p>
  275. <p>Attribute nodes are never passed to the filter. The filter implementation can choose to remove the node from the stream or to terminate the serialization early.</p>
  276. <dl class="params"><dt>Parameters</dt><dd>
  277. <table class="params">
  278. <tr><td class="paramname">filter</td><td>The writer filter to be used. </td></tr>
  279. </table>
  280. </dd>
  281. </dl>
  282. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDOMLSSerializer.html#ac74d91ba22be19b8b8349415da5833d0" title="Return the WriterFilter used. ">getFilter</a> </dd></dl>
  283. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  284. </div>
  285. </div>
  286. <a class="anchor" id="a56882d2fe0b4a0ecb1b3968febbcf4a3"></a>
  287. <div class="memitem">
  288. <div class="memproto">
  289. <table class="mlabels">
  290. <tr>
  291. <td class="mlabels-left">
  292. <table class="memname">
  293. <tr>
  294. <td class="memname">virtual void DOMLSSerializer::setNewLine </td>
  295. <td>(</td>
  296. <td class="paramtype">const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *const&#160;</td>
  297. <td class="paramname"><em>newLine</em></td><td>)</td>
  298. <td></td>
  299. </tr>
  300. </table>
  301. </td>
  302. <td class="mlabels-right">
  303. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  304. </tr>
  305. </table>
  306. </div><div class="memdoc">
  307. <p>The end-of-line sequence of characters to be used in the XML being written out. </p>
  308. <p>The only permitted values are these: </p><dl>
  309. <dt><code>null</code> </dt>
  310. <dd>Use a default end-of-line sequence. DOM implementations should choose the default to match the usual convention for text files in the environment being used. Implementations must choose a default sequence that matches one of those allowed by 2.11 "End-of-Line
  311. Handling". However, Xerces-C++ always uses LF when this property is set to <code>null</code> since otherwise automatic translation of LF to CR-LF on Windows for text files would result in such files containing CR-CR-LF. If you need Windows-style end of line sequences in your output, consider writing to a file opened in text mode or explicitly set this property to CR-LF. </dd>
  312. <dt>CR </dt>
  313. <dd>The carriage-return character (#xD). </dd>
  314. <dt>CR-LF </dt>
  315. <dd>The carriage-return and line-feed characters (#xD #xA). </dd>
  316. <dt>LF </dt>
  317. <dd>The line-feed character (#xA). </dd>
  318. </dl>
  319. <p><br />
  320. The default value for this attribute is <code>null</code>.</p>
  321. <dl class="params"><dt>Parameters</dt><dd>
  322. <table class="params">
  323. <tr><td class="paramname">newLine</td><td>The end-of-line sequence of characters to be used. </td></tr>
  324. </table>
  325. </dd>
  326. </dl>
  327. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classDOMLSSerializer.html#abece8f8c5a5e60d12c71640f502fe02c" title="Return the end-of-line sequence of characters to be used in the XML being written out...">getNewLine</a> </dd></dl>
  328. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  329. </div>
  330. </div>
  331. <a class="anchor" id="a5bcb91b60535ae26ff294a2eff65af0a"></a>
  332. <div class="memitem">
  333. <div class="memproto">
  334. <table class="mlabels">
  335. <tr>
  336. <td class="mlabels-left">
  337. <table class="memname">
  338. <tr>
  339. <td class="memname">virtual bool DOMLSSerializer::write </td>
  340. <td>(</td>
  341. <td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> *&#160;</td>
  342. <td class="paramname"><em>nodeToWrite</em>, </td>
  343. </tr>
  344. <tr>
  345. <td class="paramkey"></td>
  346. <td></td>
  347. <td class="paramtype"><a class="el" href="classDOMLSOutput.html">DOMLSOutput</a> *const&#160;</td>
  348. <td class="paramname"><em>destination</em>&#160;</td>
  349. </tr>
  350. <tr>
  351. <td></td>
  352. <td>)</td>
  353. <td></td><td></td>
  354. </tr>
  355. </table>
  356. </td>
  357. <td class="mlabels-right">
  358. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  359. </tr>
  360. </table>
  361. </div><div class="memdoc">
  362. <p>Write out the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
  363. <p>Writing a Document or Entity node produces a serialized form that is well formed XML. Writing other node types produces a fragment of text in a form that is not fully defined by this document, but that should be useful to a human for debugging or diagnostic purposes.</p>
  364. <dl class="params"><dt>Parameters</dt><dd>
  365. <table class="params">
  366. <tr><td class="paramname">nodeToWrite</td><td>The <code>Document</code> or <code>Entity</code> node to be written. For other node types, something sensible should be written, but the exact serialized form is not specified. </td></tr>
  367. <tr><td class="paramname">destination</td><td>The destination for the data to be written. </td></tr>
  368. </table>
  369. </dd>
  370. </dl>
  371. <dl class="section return"><dt>Returns</dt><dd>Returns <code>true</code> if <code>node</code> was successfully serialized and <code>false</code> in case a failure occured and the failure wasn't canceled by the error handler. </dd></dl>
  372. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  373. </div>
  374. </div>
  375. <a class="anchor" id="ab4e20c70b2d3da08f350632bbf697409"></a>
  376. <div class="memitem">
  377. <div class="memproto">
  378. <table class="mlabels">
  379. <tr>
  380. <td class="mlabels-left">
  381. <table class="memname">
  382. <tr>
  383. <td class="memname">virtual <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a>* DOMLSSerializer::writeToString </td>
  384. <td>(</td>
  385. <td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> *&#160;</td>
  386. <td class="paramname"><em>nodeToWrite</em>, </td>
  387. </tr>
  388. <tr>
  389. <td class="paramkey"></td>
  390. <td></td>
  391. <td class="paramtype"><a class="el" href="classMemoryManager.html">MemoryManager</a> *&#160;</td>
  392. <td class="paramname"><em>manager</em> = <code>NULL</code>&#160;</td>
  393. </tr>
  394. <tr>
  395. <td></td>
  396. <td>)</td>
  397. <td></td><td></td>
  398. </tr>
  399. </table>
  400. </td>
  401. <td class="mlabels-right">
  402. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  403. </tr>
  404. </table>
  405. </div><div class="memdoc">
  406. <p>Serialize the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
  407. <p>The result of serializing the node is returned as a string. Writing a Document or Entity node produces a serialized form that is well formed XML. Writing other node types produces a fragment of text in a form that is not fully defined by this document, but that should be useful to a human for debugging or diagnostic purposes.</p>
  408. <dl class="params"><dt>Parameters</dt><dd>
  409. <table class="params">
  410. <tr><td class="paramname">nodeToWrite</td><td>The node to be written. </td></tr>
  411. <tr><td class="paramname">manager</td><td>The memory manager to be used to allocate the result string. If NULL is used, the memory manager used to construct the serializer will be used. </td></tr>
  412. </table>
  413. </dd>
  414. </dl>
  415. <dl class="section return"><dt>Returns</dt><dd>Returns the serialized data, or <code>null</code> in case a failure occured and the failure wasn't canceled by the error handler. The returned string is always in UTF-16. The encoding information available in <a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a> is ignored in <a class="el" href="classDOMLSSerializer.html#ab4e20c70b2d3da08f350632bbf697409" title="Serialize the specified node as described above in the description of DOMLSSerializer. ">writeToString()</a>. </dd></dl>
  416. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  417. </div>
  418. </div>
  419. <a class="anchor" id="a8887f89ce4b7d7d70b72f24575c8863c"></a>
  420. <div class="memitem">
  421. <div class="memproto">
  422. <table class="mlabels">
  423. <tr>
  424. <td class="mlabels-left">
  425. <table class="memname">
  426. <tr>
  427. <td class="memname">virtual bool DOMLSSerializer::writeToURI </td>
  428. <td>(</td>
  429. <td class="paramtype">const <a class="el" href="classDOMNode.html">DOMNode</a> *&#160;</td>
  430. <td class="paramname"><em>nodeToWrite</em>, </td>
  431. </tr>
  432. <tr>
  433. <td class="paramkey"></td>
  434. <td></td>
  435. <td class="paramtype">const <a class="el" href="Xerces__autoconf__config_8borland_8hpp.html#a8cb107980a360c490ad7661f5d27cc0e">XMLCh</a> *&#160;</td>
  436. <td class="paramname"><em>uri</em>&#160;</td>
  437. </tr>
  438. <tr>
  439. <td></td>
  440. <td>)</td>
  441. <td></td><td></td>
  442. </tr>
  443. </table>
  444. </td>
  445. <td class="mlabels-right">
  446. <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
  447. </tr>
  448. </table>
  449. </div><div class="memdoc">
  450. <p>Write out the specified node as described above in the description of <code><a class="el" href="classDOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
  451. <p>Writing a Document or Entity node produces a serialized form that is well formed XML. Writing other node types produces a fragment of text in a form that is not fully defined by this document, but that should be useful to a human for debugging or diagnostic purposes.</p>
  452. <dl class="params"><dt>Parameters</dt><dd>
  453. <table class="params">
  454. <tr><td class="paramname">nodeToWrite</td><td>The <code>Document</code> or <code>Entity</code> node to be written. For other node types, something sensible should be written, but the exact serialized form is not specified. </td></tr>
  455. <tr><td class="paramname">uri</td><td>The destination for the data to be written. </td></tr>
  456. </table>
  457. </dd>
  458. </dl>
  459. <dl class="section return"><dt>Returns</dt><dd>Returns <code>true</code> if <code>node</code> was successfully serialized and <code>false</code> in case a failure occured and the failure wasn't canceled by the error handler. </dd></dl>
  460. <dl class="section since"><dt>Since</dt><dd>DOM Level 3 </dd></dl>
  461. </div>
  462. </div>
  463. <hr/>The documentation for this class was generated from the following file:<ul>
  464. <li><a class="el" href="DOMLSSerializer_8hpp_source.html">DOMLSSerializer.hpp</a></li>
  465. </ul>
  466. </div><!-- contents -->
  467. <!-- start footer part -->
  468. <hr class="footer"/><address class="footer"><small>
  469. Generated on Wed Mar 18 2015 10:43:38 for Xerces-C++ by &#160;<a href="http://www.doxygen.org/index.html">
  470. <img class="footer" src="doxygen.png" alt="doxygen"/>
  471. </a> 1.8.9.1
  472. </small></address>
  473. </body>
  474. </html>