<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">The <aclass="el"href="classxercesc_1_1DOMConfiguration.html"title="The DOMConfiguration interface represents the configuration of a document and maintains...">DOMConfiguration</a> object used by the LSSerializer when serializing a DOM node. <ahref="#aaf0e8286a9f19e459bc1ea4c5ab2c49a"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">The end-of-line sequence of characters to be used in the XML being written out. <ahref="#a43effa49c56258bd51ac7fddea8245c1"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">When the application provides a filter, the serializer will call out to the filter before serializing each Node. <ahref="#ad984a18ce922002cc6d9be54cb2de7ae"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Return the end-of-line sequence of characters to be used in the XML being written out. <ahref="#a9dbcf38438186863844ef44a2226ee0a"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Return the WriterFilter used. <ahref="#a5c5c80c94619eda2488686c937413956"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Write out the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. <ahref="#a8209d55732aa29c827512856bf51464a"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Write out the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. <ahref="#ac2b04937851b70f60cef6c1f3a914ed8"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Serialize the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. <ahref="#a83d7c62ee96523dbcd79011860ffc555"></a><br/></td></tr>
<tr><tdclass="mdescLeft"> </td><tdclass="mdescRight">Called to indicate that this Writer is no longer in use and that the implementation may relinquish any resources associated with it. <ahref="#afdf76237beed6293737f3aebf5f8f749"></a><br/></td></tr>
<tr><tdcolspan="2"><h2>Protected Member Functions</h2></td></tr>
<p>The <aclass="el"href="classxercesc_1_1DOMConfiguration.html"title="The DOMConfiguration interface represents the configuration of a document and maintains...">DOMConfiguration</a> object used by the LSSerializer when serializing a DOM node. </p>
<p>In addition to the parameters recognized in on the <code><aclass="el"href="classxercesc_1_1DOMConfiguration.html"title="The DOMConfiguration interface represents the configuration of a document and maintains...">DOMConfiguration</a></code> interface defined in [DOM Level 3 Core], the <code><aclass="el"href="classxercesc_1_1DOMConfiguration.html"title="The DOMConfiguration interface represents the configuration of a document and maintains...">DOMConfiguration</a></code> objects for <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code> add or modify the following parameters:</p>
<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>
<p>"discard-default-content" true [required] (default) Use the <aclass="el"href="classxercesc_1_1DOMAttr.html#ac2c2e4b40e9d9d94f5264794aa140490"title="Returns true if the attribute received its value explicitly in the XML document,...">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 <aclass="el"href="classxercesc_1_1DOMAttr.html#ac2c2e4b40e9d9d94f5264794aa140490"title="Returns true if the attribute received its value explicitly in the XML document,...">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>
<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>
<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>
<p>"normalize-characters" This parameter is equivalent to the one defined by <code><aclass="el"href="classxercesc_1_1DOMConfiguration.html"title="The DOMConfiguration interface represents the configuration of a document and maintains...">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>
<p>"xml-declaration" true [required] (default) If a <aclass="el"href="classxercesc_1_1DOMDocument.html"title="The DOMDocument interface represents the entire XML document.">DOMDocument</a>, <aclass="el"href="classxercesc_1_1DOMElement.html"title="By far the vast majority of objects (apart from text) that authors encounter when...">DOMElement</a>, or <aclass="el"href="classxercesc_1_1DOMEntity.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 <aclass="el"href="classxercesc_1_1DOMLSSerializer.html#a8209d55732aa29c827512856bf51464a"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>
<p>"error-handler" Contains a <aclass="el"href="classxercesc_1_1DOMErrorHandler.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 <aclass="el"href="classxercesc_1_1DOMErrorHandler.html"title="Basic interface for DOM error handlers.">DOMErrorHandler</a> registered using this parameter. The implementation may provide a default <aclass="el"href="classxercesc_1_1DOMErrorHandler.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 <aclass="el"href="classxercesc_1_1DOMDocument.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>
<dlclass="return"><dt><b>Returns:</b></dt><dd>The pointer to the configuration object. </dd></dl>
<dlclass="see"><dt><b>See also:</b></dt><dd><aclass="el"href="classxercesc_1_1DOMLSSerializer.html#ad984a18ce922002cc6d9be54cb2de7ae"title="When the application provides a filter, the serializer will call out to the filter...">setFilter</a></dd></dl>
<p>Return the end-of-line sequence of characters to be used in the XML being written out. </p>
<dlclass="return"><dt><b>Returns:</b></dt><dd>The end-of-line sequence of characters to be used. </dd></dl>
<dlclass="see"><dt><b>See also:</b></dt><dd><aclass="el"href="classxercesc_1_1DOMLSSerializer.html#a43effa49c56258bd51ac7fddea8245c1"title="The end-of-line sequence of characters to be used in the XML being written out.">setNewLine</a></dd></dl>
<p>When the application provides a filter, the serializer will call out to the filter before serializing each Node. </p>
<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>
<dlclass="see"><dt><b>See also:</b></dt><dd><aclass="el"href="classxercesc_1_1DOMLSSerializer.html#a5c5c80c94619eda2488686c937413956"title="Return the WriterFilter used.">getFilter</a></dd></dl>
<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
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>
<dlclass="see"><dt><b>See also:</b></dt><dd><aclass="el"href="classxercesc_1_1DOMLSSerializer.html#a9dbcf38438186863844ef44a2226ee0a"title="Return the end-of-line sequence of characters to be used in the XML being written...">getNewLine</a></dd></dl>
<p>Write out the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
<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>
<tr><tdvalign="top"></td><tdvalign="top"><em>nodeToWrite</em> </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>
<tr><tdvalign="top"></td><tdvalign="top"><em>destination</em> </td><td>The destination for the data to be written. </td></tr>
<dlclass="return"><dt><b>Returns:</b></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>
<p>Serialize the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
<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>
<tr><tdvalign="top"></td><tdvalign="top"><em>nodeToWrite</em> </td><td>The node to be written. </td></tr>
<tr><tdvalign="top"></td><tdvalign="top"><em>manager</em> </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>
<dlclass="return"><dt><b>Returns:</b></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 <aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a> is ignored in <aclass="el"href="classxercesc_1_1DOMLSSerializer.html#a83d7c62ee96523dbcd79011860ffc555"title="Serialize the specified node as described above in the description of DOMLSSerializer...">writeToString()</a>. </dd></dl>
<p>Write out the specified node as described above in the description of <code><aclass="el"href="classxercesc_1_1DOMLSSerializer.html">DOMLSSerializer</a></code>. </p>
<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>
<tr><tdvalign="top"></td><tdvalign="top"><em>nodeToWrite</em> </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>
<tr><tdvalign="top"></td><tdvalign="top"><em>uri</em> </td><td>The destination for the data to be written. </td></tr>
<dlclass="return"><dt><b>Returns:</b></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>
