source: NonGTP/Xerces/xerces/doc/html/apiDocs/classDOMDocument.html @ 358

Revision 358, 103.3 KB checked in by bittner, 19 years ago (diff)

xerces added
Line 
1<HTML><HEAD><SCRIPT language="JavaScript" src="../resources/script.js" type="text/javascript"></SCRIPT><TITLE>DOMDocument 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>
2  <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>
3
4  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
5
6  <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>
7  <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>
8  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
9  <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>
10  <A href="http://xml.apache.org/dist/xerces-c/" onMouseOut="rolloverOff('side-ext-18');" onMouseOver="rolloverOn('side-ext-18');"><IMG alt="Download" border="0" height="12" hspace="0" name="side-ext-18" onLoad="rolloverLoad('side-ext-18','../graphics/ext-18-label-2.jpg','../graphics/ext-18-label-3.jpg');" src="../graphics/ext-18-label-3.jpg" vspace="0" width="120"></A><BR>
11  <A href="../build.html" onMouseOut="rolloverOff('side-build');" onMouseOver="rolloverOn('side-build');"><IMG alt="Build" 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>
12
13  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
14  <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> 
15  <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>
16  <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> 
17
18  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR> 
19  <A href="../ApacheDOMC++Binding.html" onMouseOut="rolloverOff('side-ext-68');" onMouseOver="rolloverOn('side-ext-68');"><IMG alt="DOM C++ Binding" border="0" height="12" hspace="0" name="side-ext-68" onLoad="rolloverLoad('side-ext-68','../graphics/ext-68-label-2.jpg','../graphics/ext-68-label-3.jpg');" src="../graphics/ext-68-label-3.jpg" vspace="0" width="120"></A><BR>
20
21  <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>
22  <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>
23
24  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
25
26  <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>
27  <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> 
28  <A href="../pdf.html" onMouseOut="rolloverOff('side-pdf');" onMouseOver="rolloverOn('side-pdf');"><IMG alt="PDF Document" border="0" height="12" hspace="0" name="side-pdf" onLoad="rolloverLoad('side-pdf','../graphics/pdf-label-2.jpg','../graphics/pdf-label-3.jpg');" src="../graphics/pdf-label-3.jpg" vspace="0" width="120"></A><BR>
29
30  <IMG border="0" height="6" hspace="0" src="../resources/separator.gif" vspace="0" width="120"><BR>
31
32  <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-xerces/c/" onMouseOut="rolloverOff('side-ext-100');" onMouseOver="rolloverOn('side-ext-100');"><IMG alt="CVS Repository" border="0" height="12" hspace="0" name="side-ext-100" onLoad="rolloverLoad('side-ext-100','../graphics/ext-100-label-2.jpg','../graphics/ext-100-label-3.jpg');" src="../graphics/ext-100-label-3.jpg" vspace="0" width="120"></A><BR>
33
34  <A href="http://marc.theaimsgroup.com/?l=xerces-c-dev" onMouseOut="rolloverOff('side-ext-102');" onMouseOver="rolloverOn('side-ext-102');"><IMG alt="Mail Archive" border="0" height="12" hspace="0" name="side-ext-102" onLoad="rolloverLoad('side-ext-102','../graphics/ext-102-label-2.jpg','../graphics/ext-102-label-3.jpg');" src="../graphics/ext-102-label-3.jpg" vspace="0" width="120"></A><BR>
35
36
37<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>
38    <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">
39
40            <P>
41<!-- Generated by Doxygen 1.2.14 -->
42<center>
43<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; </center>
44<hr><h1>DOMDocument Class Reference</h1>The <code>DOMDocument</code> interface represents the entire XML document.
45<a href="#_details">More...</a>
46<p>
47Inheritance diagram for DOMDocument:<p><center><img src="classDOMDocument__inherit__graph.gif" border="0" usemap="#DOMDocument__inherit__map" alt="Inheritance graph"></center>
48<map name="DOMDocument__inherit__map">
49<area href="classDOMDocumentRange.html" shape="rect" coords="7,36,148,17" alt="">
50<area href="classDOMXPathEvaluator.html" shape="rect" coords="172,36,308,17" alt="">
51<area href="classDOMDocumentTraversal.html" shape="rect" coords="332,36,492,17" alt="">
52<area href="classDOMNode.html" shape="rect" coords="516,36,588,17" alt="">
53</map>
54<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center>Collaboration diagram for DOMDocument:<p><center><img src="classDOMDocument__coll__graph.gif" border="0" usemap="#DOMDocument__coll__map" alt="Collaboration graph"></center>
55<map name="DOMDocument__coll__map">
56<area href="classDOMDocumentRange.html" shape="rect" coords="7,36,148,17" alt="">
57<area href="classDOMXPathEvaluator.html" shape="rect" coords="172,36,308,17" alt="">
58<area href="classDOMDocumentTraversal.html" shape="rect" coords="332,36,492,17" alt="">
59<area href="classDOMNode.html" shape="rect" coords="516,36,588,17" alt="">
60</map>
61<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classDOMDocument-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
62<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
63<tr><td colspan="2"><div class="groupHeader">Destructor</div></td></tr>
64<tr><td nowrap align=right valign=top>virtual&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z27_0">~DOMDocument</a> ()</td></tr>
65<tr><td>&nbsp;</td><td><font size=-1><em>Destructor.</em> <a href="#z27_0">More...</a><em></em></font><br><br></td></tr>
66<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 1</div></td></tr>
67<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMElement.html">DOMElement</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_0">createElement</a> (const XMLCh *tagName)=0</td></tr>
68<tr><td>&nbsp;</td><td><font size=-1><em>Creates an element of the type specified.</em> <a href="#z28_0">More...</a><em></em></font><br><br></td></tr>
69<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_1">createDocumentFragment</a> ()=0</td></tr>
70<tr><td>&nbsp;</td><td><font size=-1><em>Creates an empty <code><a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a></code> object.</em> <a href="#z28_1">More...</a><em></em></font><br><br></td></tr>
71<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMText.html">DOMText</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_2">createTextNode</a> (const XMLCh *data)=0</td></tr>
72<tr><td>&nbsp;</td><td><font size=-1><em>Creates a <code><a class="el" href="classDOMText.html">DOMText</a></code> node given the specified string.</em> <a href="#z28_2">More...</a><em></em></font><br><br></td></tr>
73<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMComment.html">DOMComment</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_3">createComment</a> (const XMLCh *data)=0</td></tr>
74<tr><td>&nbsp;</td><td><font size=-1><em>Creates a <code><a class="el" href="classDOMComment.html">DOMComment</a></code> node given the specified string.</em> <a href="#z28_3">More...</a><em></em></font><br><br></td></tr>
75<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMCDATASection.html">DOMCDATASection</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_4">createCDATASection</a> (const XMLCh *data)=0</td></tr>
76<tr><td>&nbsp;</td><td><font size=-1><em>Creates a <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> node whose value is the specified string.</em> <a href="#z28_4">More...</a><em></em></font><br><br></td></tr>
77<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_5">createProcessingInstruction</a> (const XMLCh *target, const XMLCh *data)=0</td></tr>
78<tr><td>&nbsp;</td><td><font size=-1><em>Creates a <code><a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a></code> node given the specified name and data strings.</em> <a href="#z28_5">More...</a><em></em></font><br><br></td></tr>
79<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMAttr.html">DOMAttr</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_6">createAttribute</a> (const XMLCh *name)=0</td></tr>
80<tr><td>&nbsp;</td><td><font size=-1><em>Creates an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> of the given name.</em> <a href="#z28_6">More...</a><em></em></font><br><br></td></tr>
81<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMEntityReference.html">DOMEntityReference</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_7">createEntityReference</a> (const XMLCh *name)=0</td></tr>
82<tr><td>&nbsp;</td><td><font size=-1><em>Creates an <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> object.</em> <a href="#z28_7">More...</a><em></em></font><br><br></td></tr>
83<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_8">getDoctype</a> () const=0</td></tr>
84<tr><td>&nbsp;</td><td><font size=-1><em>The Document Type Declaration (see <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code>) associated with this document.</em> <a href="#z28_8">More...</a><em></em></font><br><br></td></tr>
85<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMImplementation.html">DOMImplementation</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_9">getImplementation</a> () const=0</td></tr>
86<tr><td>&nbsp;</td><td><font size=-1><em>The <code><a class="el" href="classDOMImplementation.html">DOMImplementation</a></code> object that handles this document.</em> <a href="#z28_9">More...</a><em></em></font><br><br></td></tr>
87<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMElement.html">DOMElement</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_10">getDocumentElement</a> () const=0</td></tr>
88<tr><td>&nbsp;</td><td><font size=-1><em>This is a convenience attribute that allows direct access to the child node that is the root element of the document.</em> <a href="#z28_10">More...</a><em></em></font><br><br></td></tr>
89<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNodeList.html">DOMNodeList</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z28_11">getElementsByTagName</a> (const XMLCh *tagname) const=0</td></tr>
90<tr><td>&nbsp;</td><td><font size=-1><em>Returns a <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> of all the <code>DOMElement(s)</code> with a given tag name in the order in which they are encountered in a preorder traversal of the <code>DOMDocument</code> tree.</em> <a href="#z28_11">More...</a><em></em></font><br><br></td></tr>
91<tr><td colspan="2"><div class="groupHeader">Functions introduced in DOM Level 2.</div></td></tr>
92<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z29_0">importNode</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *importedNode, bool deep)=0</td></tr>
93<tr><td>&nbsp;</td><td><font size=-1><em>Imports a node from another document to this document.</em> <a href="#z29_0">More...</a><em></em></font><br><br></td></tr>
94<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMElement.html">DOMElement</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z29_1">createElementNS</a> (const XMLCh *namespaceURI, const XMLCh *qualifiedName)=0</td></tr>
95<tr><td>&nbsp;</td><td><font size=-1><em>Creates an element of the given qualified name and namespace URI.</em> <a href="#z29_1">More...</a><em></em></font><br><br></td></tr>
96<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMAttr.html">DOMAttr</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z29_2">createAttributeNS</a> (const XMLCh *namespaceURI, const XMLCh *qualifiedName)=0</td></tr>
97<tr><td>&nbsp;</td><td><font size=-1><em>Creates an attribute of the given qualified name and namespace URI.</em> <a href="#z29_2">More...</a><em></em></font><br><br></td></tr>
98<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNodeList.html">DOMNodeList</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z29_3">getElementsByTagNameNS</a> (const XMLCh *namespaceURI, const XMLCh *localName) const=0</td></tr>
99<tr><td>&nbsp;</td><td><font size=-1><em>Returns a <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> of all the <code>DOMElement(s)</code> with a given local name and namespace URI in the order in which they are encountered in a preorder traversal of the <code>DOMDocument</code> tree.</em> <a href="#z29_3">More...</a><em></em></font><br><br></td></tr>
100<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMElement.html">DOMElement</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z29_4">getElementById</a> (const XMLCh *elementId) const=0</td></tr>
101<tr><td>&nbsp;</td><td><font size=-1><em>Returns the <code><a class="el" href="classDOMElement.html">DOMElement</a></code> whose <code>ID</code> is given by <code>elementId</code>.</em> <a href="#z29_4">More...</a><em></em></font><br><br></td></tr>
102<tr><td colspan="2"><div class="groupHeader">Non-standard extension</div></td></tr>
103<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_0">getActualEncoding</a> () const=0</td></tr>
104<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying the actual encoding of this document.</em> <a href="#z30_0">More...</a><em></em></font><br><br></td></tr>
105<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_1">setActualEncoding</a> (const XMLCh *actualEncoding)=0</td></tr>
106<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying the actual encoding of this document.</em> <a href="#z30_1">More...</a><em></em></font><br><br></td></tr>
107<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_2">getEncoding</a> () const=0</td></tr>
108<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, the encoding of this document.</em> <a href="#z30_2">More...</a><em></em></font><br><br></td></tr>
109<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_3">setEncoding</a> (const XMLCh *encoding)=0</td></tr>
110<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, the encoding of this document.</em> <a href="#z30_3">More...</a><em></em></font><br><br></td></tr>
111<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_4">getStandalone</a> () const=0</td></tr>
112<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, whether this document is standalone.</em> <a href="#z30_4">More...</a><em></em></font><br><br></td></tr>
113<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_5">setStandalone</a> (bool standalone)=0</td></tr>
114<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, whether this document is standalone.</em> <a href="#z30_5">More...</a><em></em></font><br><br></td></tr>
115<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_6">getVersion</a> () const=0</td></tr>
116<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, the version number of this document.</em> <a href="#z30_6">More...</a><em></em></font><br><br></td></tr>
117<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_7">setVersion</a> (const XMLCh *version)=0</td></tr>
118<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying, as part of the XML declaration, the version number of this document.</em> <a href="#z30_7">More...</a><em></em></font><br><br></td></tr>
119<tr><td nowrap align=right valign=top>virtual const XMLCh *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_8">getDocumentURI</a> () const=0</td></tr>
120<tr><td>&nbsp;</td><td><font size=-1><em>The location of the document or <code>null</code> if undefined.</em> <a href="#z30_8">More...</a><em></em></font><br><br></td></tr>
121<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_9">setDocumentURI</a> (const XMLCh *documentURI)=0</td></tr>
122<tr><td>&nbsp;</td><td><font size=-1><em>The location of the document or <code>null</code> if undefined.</em> <a href="#z30_9">More...</a><em></em></font><br><br></td></tr>
123<tr><td nowrap align=right valign=top>virtual bool&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_10">getStrictErrorChecking</a> () const=0</td></tr>
124<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying whether errors checking is enforced or not.</em> <a href="#z30_10">More...</a><em></em></font><br><br></td></tr>
125<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_11">setStrictErrorChecking</a> (bool strictErrorChecking)=0</td></tr>
126<tr><td>&nbsp;</td><td><font size=-1><em>An attribute specifying whether errors checking is enforced or not.</em> <a href="#z30_11">More...</a><em></em></font><br><br></td></tr>
127<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_12">renameNode</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *n, const XMLCh *namespaceURI, const XMLCh *name)=0</td></tr>
128<tr><td>&nbsp;</td><td><font size=-1><em>Rename an existing node.</em> <a href="#z30_12">More...</a><em></em></font><br><br></td></tr>
129<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_13">adoptNode</a> (<a class="el" href="classDOMNode.html">DOMNode</a> *source)=0</td></tr>
130<tr><td>&nbsp;</td><td><font size=-1><em>Changes the <code>ownerDocument</code> of a node, its children, as well as the attached attribute nodes if there are any.</em> <a href="#z30_13">More...</a><em></em></font><br><br></td></tr>
131<tr><td nowrap align=right valign=top>virtual void&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_14">normalizeDocument</a> ()=0</td></tr>
132<tr><td>&nbsp;</td><td><font size=-1><em>This method acts as if the document was going through a save and load cycle, putting the document in a "normal" form.</em> <a href="#z30_14">More...</a><em></em></font><br><br></td></tr>
133<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMConfiguration.html">DOMConfiguration</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_15">getDOMConfiguration</a> () const=0</td></tr>
134<tr><td>&nbsp;</td><td><font size=-1><em>The configuration used when Document.normalizeDocument is invoked.</em> <a href="#z30_15">More...</a><em></em></font><br><br></td></tr>
135<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMEntity.html">DOMEntity</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_16">createEntity</a> (const XMLCh *name)=0</td></tr>
136<tr><td>&nbsp;</td><td><font size=-1><em>Non-standard extension.</em> <a href="#z30_16">More...</a><em></em></font><br><br></td></tr>
137<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_17">createDocumentType</a> (const XMLCh *name)=0</td></tr>
138<tr><td>&nbsp;</td><td><font size=-1><em>Non-standard extension.</em> <a href="#z30_17">More...</a><em></em></font><br><br></td></tr>
139<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_18">createDocumentType</a> (const XMLCh *qName, const XMLCh *publicId, const XMLCh *systemId)</td></tr>
140<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMNotation.html">DOMNotation</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_19">createNotation</a> (const XMLCh *name)=0</td></tr>
141<tr><td>&nbsp;</td><td><font size=-1><em>Non-standard extension.</em> <a href="#z30_19">More...</a><em></em></font><br><br></td></tr>
142<tr><td nowrap align=right valign=top>virtual <a class="el" href="classDOMElement.html">DOMElement</a> *&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z30_20">createElementNS</a> (const XMLCh *namespaceURI, const XMLCh *qualifiedName, const XMLSSize_t lineNum, const XMLSSize_t columnNum)=0</td></tr>
143<tr><td>&nbsp;</td><td><font size=-1><em>Non-standard extension.</em> <a href="#z30_20">More...</a><em></em></font><br><br></td></tr>
144<tr><td colspan=2><br><h2>Protected Methods</h2></td></tr>
145<tr><td colspan="2"><div class="groupHeader">Hidden constructors</div></td></tr>
146<tr><td nowrap align=right valign=top>&nbsp;</td><td valign=bottom><a class="el" href="classDOMDocument.html#z25_0">DOMDocument</a> ()</td></tr>
147</table>
148<hr><a name="_details"></a><h2>Detailed Description</h2>
149The <code>DOMDocument</code> interface represents the entire XML document.
150<p>
151Conceptually, it is the root of the document tree, and provides the primary access to the document's data.
152<p>
153Since elements, text nodes, comments, processing instructions, etc. cannot exist outside the context of a <code>DOMDocument</code>, the <code>DOMDocument</code> interface also contains the factory methods needed to create these objects. The <code><a class="el" href="classDOMNode.html">DOMNode</a></code> objects created have a <code>ownerDocument</code> attribute which associates them with the <code>DOMDocument</code> within whose context they were created.
154<p>
155See also the <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113">Document Object Model (DOM) Level 2 Core Specification</a>.
156<p>
157<hr><h2>Constructor &amp; Destructor Documentation</h2>
158<a name="z25_0" doxytag="DOMDocument::DOMDocument"></a><p>
159<table width="100%" cellpadding="2" cellspacing="0" border="0">
160  <tr>
161    <td class="md">
162      <table cellpadding="0" cellspacing="0" border="0">
163        <tr>
164          <td class="md" nowrap valign="top"> DOMDocument::DOMDocument </td>
165          <td class="md" valign="top">(&nbsp;</td>
166          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
167          <td class="md" valign="top">)&nbsp;</td>
168          <td class="md" nowrap><code> [protected]</code></td>
169        </tr>
170
171      </table>
172    </td>
173  </tr>
174</table>
175<table cellspacing=5 cellpadding=0 border=0>
176  <tr>
177    <td>
178      &nbsp;
179    </td>
180    <td>
181
182<p>
183    </td>
184  </tr>
185</table>
186<a name="z27_0" doxytag="DOMDocument::~DOMDocument"></a><p>
187<table width="100%" cellpadding="2" cellspacing="0" border="0">
188  <tr>
189    <td class="md">
190      <table cellpadding="0" cellspacing="0" border="0">
191        <tr>
192          <td class="md" nowrap valign="top"> virtual DOMDocument::~DOMDocument </td>
193          <td class="md" valign="top">(&nbsp;</td>
194          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
195          <td class="md" valign="top">)&nbsp;</td>
196          <td class="md" nowrap><code> [virtual]</code></td>
197        </tr>
198
199      </table>
200    </td>
201  </tr>
202</table>
203<table cellspacing=5 cellpadding=0 border=0>
204  <tr>
205    <td>
206      &nbsp;
207    </td>
208    <td>
209
210<p>
211Destructor.
212<p>
213    </td>
214  </tr>
215</table>
216<hr><h2>Member Function Documentation</h2>
217<a name="z30_13" doxytag="DOMDocument::adoptNode"></a><p>
218<table width="100%" cellpadding="2" cellspacing="0" border="0">
219  <tr>
220    <td class="md">
221      <table cellpadding="0" cellspacing="0" border="0">
222        <tr>
223          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMDocument::adoptNode </td>
224          <td class="md" valign="top">(&nbsp;</td>
225          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
226          <td class="mdname1" valign="top" nowrap>&nbsp; <em>source</em>          </td>
227          <td class="md" valign="top">)&nbsp;</td>
228          <td class="md" nowrap><code> [pure virtual]</code></td>
229        </tr>
230
231      </table>
232    </td>
233  </tr>
234</table>
235<table cellspacing=5 cellpadding=0 border=0>
236  <tr>
237    <td>
238      &nbsp;
239    </td>
240    <td>
241
242<p>
243Changes the <code>ownerDocument</code> of a node, its children, as well as the attached attribute nodes if there are any.
244<p>
245If the node has a parent it is first removed from its parent child list. This effectively allows moving a subtree from one document to another. The following list describes the specifics for each type of node.
246<p>
247
248<p>
249<b>"Experimental - subject to change"</b>
250<p>
251
252<dl compact>
253 <dt> ATTRIBUTE_NODE <dd>The <code>ownerElement</code> attribute is set to <code>null</code> and the <code>specified</code> flag is set to <code>true</code> on the adopted <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code>. The descendants of the source <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> are recursively adopted. <dt> DOCUMENT_FRAGMENT_NODE <dd>The descendants of the source node are recursively adopted. <dt>DOCUMENT_NODE <dd><code>DOMDocument</code> nodes cannot be adopted. <dt>DOCUMENT_TYPE_NODE <dd><code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> nodes cannot be adopted. <dt>ELEMENT_NODE <dd>Specified attribute nodes of the source element are adopted, and the generated <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes. Default attributes are discarded, though if the document being adopted into defines default attributes for this element name, those are assigned. The descendants of the source element are recursively adopted. <dt>ENTITY_NODE <dd><code><a class="el" href="classDOMEntity.html">DOMEntity</a></code> nodes cannot be adopted. <dt> ENTITY_REFERENCE_NODE <dd>Only the <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> node itself is adopted, the descendants are discarded, since the source and destination documents might have defined the entity differently. If the document being imported into provides a definition for this entity name, its value is assigned. <dt>NOTATION_NODE <dd><code><a class="el" href="classDOMNotation.html">DOMNotation</a></code> nodes cannot be adopted. <dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE <dd>These nodes can all be adopted. No specifics.
254</dl>
255 <dl compact><dt><b>
256Parameters: </b><dd>
257<table border=0 cellspacing=2 cellpadding=0>
258<tr><td valign=top><em>source</em>&nbsp;</td><td>
259The node to move into this document. </td></tr>
260</table>
261</dl><dl compact><dt><b>
262Returns: </b><dd>
263The adopted node, or <code>null</code> if this operation fails, such as when the source node comes from a different implementation. </dl><dl compact><dt><b>
264Exceptions: </b><dd>
265<table border=0 cellspacing=2 cellpadding=0>
266<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
267 NOT_SUPPORTED_ERR: Raised if the source node is of type <code>DOCUMENT</code>, <code>DOCUMENT_TYPE</code>. <br>
268NO_MODIFICATION_ALLOWED_ERR: Raised when the source node is readonly. </td></tr>
269</table>
270</dl><dl compact><dt><b>
271Since: </b><dd>
272DOM Level 3 </dl>    </td>
273  </tr>
274</table>
275<a name="z28_6" doxytag="DOMDocument::createAttribute"></a><p>
276<table width="100%" cellpadding="2" cellspacing="0" border="0">
277  <tr>
278    <td class="md">
279      <table cellpadding="0" cellspacing="0" border="0">
280        <tr>
281          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMAttr.html">DOMAttr</a>* DOMDocument::createAttribute </td>
282          <td class="md" valign="top">(&nbsp;</td>
283          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
284          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
285          <td class="md" valign="top">)&nbsp;</td>
286          <td class="md" nowrap><code> [pure virtual]</code></td>
287        </tr>
288
289      </table>
290    </td>
291  </tr>
292</table>
293<table cellspacing=5 cellpadding=0 border=0>
294  <tr>
295    <td>
296      &nbsp;
297    </td>
298    <td>
299
300<p>
301Creates an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> of the given name.
302<p>
303Note that the <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> instance can then be set on an <code><a class="el" href="classDOMElement.html">DOMElement</a></code> using the <code>setAttributeNode</code> method. <br>
304To create an attribute with a qualified name and namespace URI, use the <code>createAttributeNS</code> method. <dl compact><dt><b>
305Parameters: </b><dd>
306<table border=0 cellspacing=2 cellpadding=0>
307<tr><td valign=top><em>name</em>&nbsp;</td><td>
308The name of the attribute. </td></tr>
309</table>
310</dl><dl compact><dt><b>
311Returns: </b><dd>
312A new <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> object with the <code>nodeName</code> attribute set to <code>name</code>, and <code>localName</code>, <code>prefix</code>, and <code>namespaceURI</code> set to <code>null</code>. The value of the attribute is the empty string. </dl><dl compact><dt><b>
313Exceptions: </b><dd>
314<table border=0 cellspacing=2 cellpadding=0>
315<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
316 INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character. </td></tr>
317</table>
318</dl><dl compact><dt><b>
319Since: </b><dd>
320DOM Level 1 </dl>    </td>
321  </tr>
322</table>
323<a name="z29_2" doxytag="DOMDocument::createAttributeNS"></a><p>
324<table width="100%" cellpadding="2" cellspacing="0" border="0">
325  <tr>
326    <td class="md">
327      <table cellpadding="0" cellspacing="0" border="0">
328        <tr>
329          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMAttr.html">DOMAttr</a>* DOMDocument::createAttributeNS </td>
330          <td class="md" valign="top">(&nbsp;</td>
331          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
332          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
333        </tr>
334        <tr>
335          <td></td>
336          <td></td>
337          <td class="md" nowrap>const XMLCh *&nbsp;</td>
338          <td class="mdname" nowrap>&nbsp; <em>qualifiedName</em></td>
339        </tr>
340        <tr>
341          <td></td>
342          <td class="md">)&nbsp;</td>
343          <td class="md" colspan="2"><code> [pure virtual]</code></td>
344        </tr>
345
346      </table>
347    </td>
348  </tr>
349</table>
350<table cellspacing=5 cellpadding=0 border=0>
351  <tr>
352    <td>
353      &nbsp;
354    </td>
355    <td>
356
357<p>
358Creates an attribute of the given qualified name and namespace URI.
359<p>
360<dl compact><dt><b>
361Parameters: </b><dd>
362<table border=0 cellspacing=2 cellpadding=0>
363<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
364The namespace URI of the attribute to create. </td></tr>
365<tr><td valign=top><em>qualifiedName</em>&nbsp;</td><td>
366The qualified name of the attribute to instantiate. </td></tr>
367</table>
368</dl><dl compact><dt><b>
369Returns: </b><dd>
370A new <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> object with the following attributes:   <table border=1 cellspacing=3 cellpadding=3><tr><td><code>Attribute</code> </td><td> <code>Value</code>   </td></tr>
371<tr><td><code>DOMNode.nodeName</code> </td><td>qualifiedName   </td></tr>
372<tr><td> <code>DOMNode.namespaceURI</code> </td><td><code>namespaceURI</code>   </td></tr>
373<tr><td> <code>DOMNode.prefix</code> </td><td>prefix, extracted from <code>qualifiedName</code>, or <code>null</code> if there is no prefix   </td></tr>
374<tr><td><code>DOMNode.localName</code> </td><td>local name, extracted from <code>qualifiedName</code>   </td></tr>
375<tr><td><code>DOMAttr.name</code> </td><td> <code>qualifiedName</code>   </td></tr>
376<tr><td><code>DOMNode.nodeValue</code> </td><td>the empty string  </td></tr></table>
377 </dl><dl compact><dt><b>
378Exceptions: </b><dd>
379<table border=0 cellspacing=2 cellpadding=0>
380<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
381 INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character, per the XML 1.0 specification . <br>
382NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is malformed per the Namespaces in XML specification, if the <code>qualifiedName</code> has a prefix and the <code>namespaceURI</code> is <code>null</code>, if the <code>qualifiedName</code> has a prefix that is "xml" and the <code>namespaceURI</code> is different from " <a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a>", or if the <code>qualifiedName</code>, or its prefix, is "xmlns" and the <code>namespaceURI</code> is different from " <a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a>". <br>
383NOT_SUPPORTED_ERR: Always thrown if the current document does not support the <code>"XML"</code> feature, since namespaces were defined by XML. </td></tr>
384</table>
385</dl><dl compact><dt><b>
386Since: </b><dd>
387DOM Level 2 </dl>    </td>
388  </tr>
389</table>
390<a name="z28_4" doxytag="DOMDocument::createCDATASection"></a><p>
391<table width="100%" cellpadding="2" cellspacing="0" border="0">
392  <tr>
393    <td class="md">
394      <table cellpadding="0" cellspacing="0" border="0">
395        <tr>
396          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMCDATASection.html">DOMCDATASection</a>* DOMDocument::createCDATASection </td>
397          <td class="md" valign="top">(&nbsp;</td>
398          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
399          <td class="mdname1" valign="top" nowrap>&nbsp; <em>data</em>          </td>
400          <td class="md" valign="top">)&nbsp;</td>
401          <td class="md" nowrap><code> [pure virtual]</code></td>
402        </tr>
403
404      </table>
405    </td>
406  </tr>
407</table>
408<table cellspacing=5 cellpadding=0 border=0>
409  <tr>
410    <td>
411      &nbsp;
412    </td>
413    <td>
414
415<p>
416Creates a <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> node whose value is the specified string.
417<p>
418<dl compact><dt><b>
419Parameters: </b><dd>
420<table border=0 cellspacing=2 cellpadding=0>
421<tr><td valign=top><em>data</em>&nbsp;</td><td>
422The data for the <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> contents. </td></tr>
423</table>
424</dl><dl compact><dt><b>
425Returns: </b><dd>
426The new <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> object. </dl><dl compact><dt><b>
427Since: </b><dd>
428DOM Level 1 </dl>    </td>
429  </tr>
430</table>
431<a name="z28_3" doxytag="DOMDocument::createComment"></a><p>
432<table width="100%" cellpadding="2" cellspacing="0" border="0">
433  <tr>
434    <td class="md">
435      <table cellpadding="0" cellspacing="0" border="0">
436        <tr>
437          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMComment.html">DOMComment</a>* DOMDocument::createComment </td>
438          <td class="md" valign="top">(&nbsp;</td>
439          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
440          <td class="mdname1" valign="top" nowrap>&nbsp; <em>data</em>          </td>
441          <td class="md" valign="top">)&nbsp;</td>
442          <td class="md" nowrap><code> [pure virtual]</code></td>
443        </tr>
444
445      </table>
446    </td>
447  </tr>
448</table>
449<table cellspacing=5 cellpadding=0 border=0>
450  <tr>
451    <td>
452      &nbsp;
453    </td>
454    <td>
455
456<p>
457Creates a <code><a class="el" href="classDOMComment.html">DOMComment</a></code> node given the specified string.
458<p>
459<dl compact><dt><b>
460Parameters: </b><dd>
461<table border=0 cellspacing=2 cellpadding=0>
462<tr><td valign=top><em>data</em>&nbsp;</td><td>
463The data for the node. </td></tr>
464</table>
465</dl><dl compact><dt><b>
466Returns: </b><dd>
467The new <code><a class="el" href="classDOMComment.html">DOMComment</a></code> object. </dl><dl compact><dt><b>
468Since: </b><dd>
469DOM Level 1 </dl>    </td>
470  </tr>
471</table>
472<a name="z28_1" doxytag="DOMDocument::createDocumentFragment"></a><p>
473<table width="100%" cellpadding="2" cellspacing="0" border="0">
474  <tr>
475    <td class="md">
476      <table cellpadding="0" cellspacing="0" border="0">
477        <tr>
478          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a>* DOMDocument::createDocumentFragment </td>
479          <td class="md" valign="top">(&nbsp;</td>
480          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
481          <td class="md" valign="top">)&nbsp;</td>
482          <td class="md" nowrap><code> [pure virtual]</code></td>
483        </tr>
484
485      </table>
486    </td>
487  </tr>
488</table>
489<table cellspacing=5 cellpadding=0 border=0>
490  <tr>
491    <td>
492      &nbsp;
493    </td>
494    <td>
495
496<p>
497Creates an empty <code><a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a></code> object.
498<p>
499<dl compact><dt><b>
500Returns: </b><dd>
501A new <code><a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a></code>. </dl><dl compact><dt><b>
502Since: </b><dd>
503DOM Level 1 </dl>    </td>
504  </tr>
505</table>
506<a name="z30_18" doxytag="DOMDocument::createDocumentType"></a><p>
507<table width="100%" cellpadding="2" cellspacing="0" border="0">
508  <tr>
509    <td class="md">
510      <table cellpadding="0" cellspacing="0" border="0">
511        <tr>
512          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a>* DOMDocument::createDocumentType </td>
513          <td class="md" valign="top">(&nbsp;</td>
514          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
515          <td class="mdname" nowrap>&nbsp; <em>qName</em>, </td>
516        </tr>
517        <tr>
518          <td></td>
519          <td></td>
520          <td class="md" nowrap>const XMLCh *&nbsp;</td>
521          <td class="mdname" nowrap>&nbsp; <em>publicId</em>, </td>
522        </tr>
523        <tr>
524          <td></td>
525          <td></td>
526          <td class="md" nowrap>const XMLCh *&nbsp;</td>
527          <td class="mdname" nowrap>&nbsp; <em>systemId</em></td>
528        </tr>
529        <tr>
530          <td></td>
531          <td class="md">)&nbsp;</td>
532          <td class="md" colspan="2"><code> [virtual]</code></td>
533        </tr>
534
535      </table>
536    </td>
537  </tr>
538</table>
539<table cellspacing=5 cellpadding=0 border=0>
540  <tr>
541    <td>
542      &nbsp;
543    </td>
544    <td>
545
546<p>
547    </td>
548  </tr>
549</table>
550<a name="z30_17" doxytag="DOMDocument::createDocumentType"></a><p>
551<table width="100%" cellpadding="2" cellspacing="0" border="0">
552  <tr>
553    <td class="md">
554      <table cellpadding="0" cellspacing="0" border="0">
555        <tr>
556          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a>* DOMDocument::createDocumentType </td>
557          <td class="md" valign="top">(&nbsp;</td>
558          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
559          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
560          <td class="md" valign="top">)&nbsp;</td>
561          <td class="md" nowrap><code> [pure virtual]</code></td>
562        </tr>
563
564      </table>
565    </td>
566  </tr>
567</table>
568<table cellspacing=5 cellpadding=0 border=0>
569  <tr>
570    <td>
571      &nbsp;
572    </td>
573    <td>
574
575<p>
576Non-standard extension.
577<p>
578Create a <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node. <dl compact><dt><b>
579Returns: </b><dd>
580A <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> that references the newly created <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a> node. </dl>    </td>
581  </tr>
582</table>
583<a name="z28_0" doxytag="DOMDocument::createElement"></a><p>
584<table width="100%" cellpadding="2" cellspacing="0" border="0">
585  <tr>
586    <td class="md">
587      <table cellpadding="0" cellspacing="0" border="0">
588        <tr>
589          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMElement.html">DOMElement</a>* DOMDocument::createElement </td>
590          <td class="md" valign="top">(&nbsp;</td>
591          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
592          <td class="mdname1" valign="top" nowrap>&nbsp; <em>tagName</em>          </td>
593          <td class="md" valign="top">)&nbsp;</td>
594          <td class="md" nowrap><code> [pure virtual]</code></td>
595        </tr>
596
597      </table>
598    </td>
599  </tr>
600</table>
601<table cellspacing=5 cellpadding=0 border=0>
602  <tr>
603    <td>
604      &nbsp;
605    </td>
606    <td>
607
608<p>
609Creates an element of the type specified.
610<p>
611Note that the instance returned implements the <code><a class="el" href="classDOMElement.html">DOMElement</a></code> interface, so attributes can be specified directly on the returned object. <br>
612In addition, if there are known attributes with default values, <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes representing them are automatically created and attached to the element. <br>
613To create an element with a qualified name and namespace URI, use the <code>createElementNS</code> method. <dl compact><dt><b>
614Parameters: </b><dd>
615<table border=0 cellspacing=2 cellpadding=0>
616<tr><td valign=top><em>tagName</em>&nbsp;</td><td>
617The name of the element type to instantiate. For XML, this is case-sensitive. </td></tr>
618</table>
619</dl><dl compact><dt><b>
620Returns: </b><dd>
621A new <code><a class="el" href="classDOMElement.html">DOMElement</a></code> object with the <code>nodeName</code> attribute set to <code>tagName</code>, and <code>localName</code>, <code>prefix</code>, and <code>namespaceURI</code> set to <code>null</code>. </dl><dl compact><dt><b>
622Exceptions: </b><dd>
623<table border=0 cellspacing=2 cellpadding=0>
624<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
625 INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character. </td></tr>
626</table>
627</dl><dl compact><dt><b>
628Since: </b><dd>
629DOM Level 1 </dl>    </td>
630  </tr>
631</table>
632<a name="z30_20" doxytag="DOMDocument::createElementNS"></a><p>
633<table width="100%" cellpadding="2" cellspacing="0" border="0">
634  <tr>
635    <td class="md">
636      <table cellpadding="0" cellspacing="0" border="0">
637        <tr>
638          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMElement.html">DOMElement</a>* DOMDocument::createElementNS </td>
639          <td class="md" valign="top">(&nbsp;</td>
640          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
641          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
642        </tr>
643        <tr>
644          <td></td>
645          <td></td>
646          <td class="md" nowrap>const XMLCh *&nbsp;</td>
647          <td class="mdname" nowrap>&nbsp; <em>qualifiedName</em>, </td>
648        </tr>
649        <tr>
650          <td></td>
651          <td></td>
652          <td class="md" nowrap>const XMLSSize_t&nbsp;</td>
653          <td class="mdname" nowrap>&nbsp; <em>lineNum</em>, </td>
654        </tr>
655        <tr>
656          <td></td>
657          <td></td>
658          <td class="md" nowrap>const XMLSSize_t&nbsp;</td>
659          <td class="mdname" nowrap>&nbsp; <em>columnNum</em></td>
660        </tr>
661        <tr>
662          <td></td>
663          <td class="md">)&nbsp;</td>
664          <td class="md" colspan="2"><code> [pure virtual]</code></td>
665        </tr>
666
667      </table>
668    </td>
669  </tr>
670</table>
671<table cellspacing=5 cellpadding=0 border=0>
672  <tr>
673    <td>
674      &nbsp;
675    </td>
676    <td>
677
678<p>
679Non-standard extension.
680<p>
681Creates an element of the given qualified name and namespace URI, and also stores line/column number info. Used by internally XSDXercesDOMParser during schema traversal.
682<p>
683<dl compact><dt><b>
684See also: </b><dd>
685<a class="el" href="classDOMDocument.html#z29_1">createElementNS</a>(const XMLCh *namespaceURI, const XMLCh *qualifiedName) </dl>    </td>
686  </tr>
687</table>
688<a name="z29_1" doxytag="DOMDocument::createElementNS"></a><p>
689<table width="100%" cellpadding="2" cellspacing="0" border="0">
690  <tr>
691    <td class="md">
692      <table cellpadding="0" cellspacing="0" border="0">
693        <tr>
694          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMElement.html">DOMElement</a>* DOMDocument::createElementNS </td>
695          <td class="md" valign="top">(&nbsp;</td>
696          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
697          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
698        </tr>
699        <tr>
700          <td></td>
701          <td></td>
702          <td class="md" nowrap>const XMLCh *&nbsp;</td>
703          <td class="mdname" nowrap>&nbsp; <em>qualifiedName</em></td>
704        </tr>
705        <tr>
706          <td></td>
707          <td class="md">)&nbsp;</td>
708          <td class="md" colspan="2"><code> [pure virtual]</code></td>
709        </tr>
710
711      </table>
712    </td>
713  </tr>
714</table>
715<table cellspacing=5 cellpadding=0 border=0>
716  <tr>
717    <td>
718      &nbsp;
719    </td>
720    <td>
721
722<p>
723Creates an element of the given qualified name and namespace URI.
724<p>
725<dl compact><dt><b>
726Parameters: </b><dd>
727<table border=0 cellspacing=2 cellpadding=0>
728<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
729The namespace URI of the element to create. </td></tr>
730<tr><td valign=top><em>qualifiedName</em>&nbsp;</td><td>
731The qualified name of the element type to instantiate. </td></tr>
732</table>
733</dl><dl compact><dt><b>
734Returns: </b><dd>
735A new <code><a class="el" href="classDOMElement.html">DOMElement</a></code> object with the following attributes:   <table border=1 cellspacing=3 cellpadding=3><tr><td><code>Attribute</code> </td><td> <code>Value</code>   </td></tr>
736<tr><td><code>DOMNode.nodeName</code> </td><td> <code>qualifiedName</code>   </td></tr>
737<tr><td><code>DOMNode.namespaceURI</code> </td><td> <code>namespaceURI</code>   </td></tr>
738<tr><td><code>DOMNode.prefix</code> </td><td>prefix, extracted from <code>qualifiedName</code>, or <code>null</code> if there is no prefix   </td></tr>
739<tr><td><code>DOMNode.localName</code> </td><td>local name, extracted from <code>qualifiedName</code>   </td></tr>
740<tr><td><code>DOMElement.tagName</code> </td><td> <code>qualifiedName</code>  </td></tr></table>
741 </dl><dl compact><dt><b>
742Exceptions: </b><dd>
743<table border=0 cellspacing=2 cellpadding=0>
744<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
745 INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character, per the XML 1.0 specification . <br>
746NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is malformed per the Namespaces in XML specification, if the <code>qualifiedName</code> has a prefix and the <code>namespaceURI</code> is <code>null</code>, or if the <code>qualifiedName</code> has a prefix that is "xml" and the <code>namespaceURI</code> is different from " <a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a>" . <br>
747NOT_SUPPORTED_ERR: Always thrown if the current document does not support the <code>"XML"</code> feature, since namespaces were defined by XML. </td></tr>
748</table>
749</dl><dl compact><dt><b>
750Since: </b><dd>
751DOM Level 2 </dl>    </td>
752  </tr>
753</table>
754<a name="z30_16" doxytag="DOMDocument::createEntity"></a><p>
755<table width="100%" cellpadding="2" cellspacing="0" border="0">
756  <tr>
757    <td class="md">
758      <table cellpadding="0" cellspacing="0" border="0">
759        <tr>
760          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMEntity.html">DOMEntity</a>* DOMDocument::createEntity </td>
761          <td class="md" valign="top">(&nbsp;</td>
762          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
763          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
764          <td class="md" valign="top">)&nbsp;</td>
765          <td class="md" nowrap><code> [pure virtual]</code></td>
766        </tr>
767
768      </table>
769    </td>
770  </tr>
771</table>
772<table cellspacing=5 cellpadding=0 border=0>
773  <tr>
774    <td>
775      &nbsp;
776    </td>
777    <td>
778
779<p>
780Non-standard extension.
781<p>
782Create a new entity. <dl compact><dt><b>
783Parameters: </b><dd>
784<table border=0 cellspacing=2 cellpadding=0>
785<tr><td valign=top><em>name</em>&nbsp;</td><td>
786The name of the entity to instantiate </td></tr>
787</table>
788</dl>    </td>
789  </tr>
790</table>
791<a name="z28_7" doxytag="DOMDocument::createEntityReference"></a><p>
792<table width="100%" cellpadding="2" cellspacing="0" border="0">
793  <tr>
794    <td class="md">
795      <table cellpadding="0" cellspacing="0" border="0">
796        <tr>
797          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMEntityReference.html">DOMEntityReference</a>* DOMDocument::createEntityReference </td>
798          <td class="md" valign="top">(&nbsp;</td>
799          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
800          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
801          <td class="md" valign="top">)&nbsp;</td>
802          <td class="md" nowrap><code> [pure virtual]</code></td>
803        </tr>
804
805      </table>
806    </td>
807  </tr>
808</table>
809<table cellspacing=5 cellpadding=0 border=0>
810  <tr>
811    <td>
812      &nbsp;
813    </td>
814    <td>
815
816<p>
817Creates an <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> object.
818<p>
819In addition, if the referenced entity is known, the child list of the <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> node is made the same as that of the corresponding <code><a class="el" href="classDOMEntity.html">DOMEntity</a></code> node.If any descendant of the <code><a class="el" href="classDOMEntity.html">DOMEntity</a></code> node has an unbound namespace prefix, the corresponding descendant of the created <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> node is also unbound; (its <code>namespaceURI</code> is <code>null</code>). The DOM Level 2 does not support any mechanism to resolve namespace prefixes. <dl compact><dt><b>
820Parameters: </b><dd>
821<table border=0 cellspacing=2 cellpadding=0>
822<tr><td valign=top><em>name</em>&nbsp;</td><td>
823The name of the entity to reference. </td></tr>
824</table>
825</dl><dl compact><dt><b>
826Returns: </b><dd>
827The new <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> object. </dl><dl compact><dt><b>
828Exceptions: </b><dd>
829<table border=0 cellspacing=2 cellpadding=0>
830<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
831 INVALID_CHARACTER_ERR: Raised if the specified name contains an illegal character. </td></tr>
832</table>
833</dl><dl compact><dt><b>
834Since: </b><dd>
835DOM Level 1 </dl>    </td>
836  </tr>
837</table>
838<a name="z30_19" doxytag="DOMDocument::createNotation"></a><p>
839<table width="100%" cellpadding="2" cellspacing="0" border="0">
840  <tr>
841    <td class="md">
842      <table cellpadding="0" cellspacing="0" border="0">
843        <tr>
844          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNotation.html">DOMNotation</a>* DOMDocument::createNotation </td>
845          <td class="md" valign="top">(&nbsp;</td>
846          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
847          <td class="mdname1" valign="top" nowrap>&nbsp; <em>name</em>          </td>
848          <td class="md" valign="top">)&nbsp;</td>
849          <td class="md" nowrap><code> [pure virtual]</code></td>
850        </tr>
851
852      </table>
853    </td>
854  </tr>
855</table>
856<table cellspacing=5 cellpadding=0 border=0>
857  <tr>
858    <td>
859      &nbsp;
860    </td>
861    <td>
862
863<p>
864Non-standard extension.
865<p>
866Create a Notation. <dl compact><dt><b>
867Parameters: </b><dd>
868<table border=0 cellspacing=2 cellpadding=0>
869<tr><td valign=top><em>name</em>&nbsp;</td><td>
870The name of the notation to instantiate </td></tr>
871</table>
872</dl><dl compact><dt><b>
873Returns: </b><dd>
874A <code><a class="el" href="classDOMNotation.html">DOMNotation</a></code> that references the newly created <a class="el" href="classDOMNotation.html">DOMNotation</a> node. </dl>    </td>
875  </tr>
876</table>
877<a name="z28_5" doxytag="DOMDocument::createProcessingInstruction"></a><p>
878<table width="100%" cellpadding="2" cellspacing="0" border="0">
879  <tr>
880    <td class="md">
881      <table cellpadding="0" cellspacing="0" border="0">
882        <tr>
883          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a>* DOMDocument::createProcessingInstruction </td>
884          <td class="md" valign="top">(&nbsp;</td>
885          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
886          <td class="mdname" nowrap>&nbsp; <em>target</em>, </td>
887        </tr>
888        <tr>
889          <td></td>
890          <td></td>
891          <td class="md" nowrap>const XMLCh *&nbsp;</td>
892          <td class="mdname" nowrap>&nbsp; <em>data</em></td>
893        </tr>
894        <tr>
895          <td></td>
896          <td class="md">)&nbsp;</td>
897          <td class="md" colspan="2"><code> [pure virtual]</code></td>
898        </tr>
899
900      </table>
901    </td>
902  </tr>
903</table>
904<table cellspacing=5 cellpadding=0 border=0>
905  <tr>
906    <td>
907      &nbsp;
908    </td>
909    <td>
910
911<p>
912Creates a <code><a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a></code> node given the specified name and data strings.
913<p>
914<dl compact><dt><b>
915Parameters: </b><dd>
916<table border=0 cellspacing=2 cellpadding=0>
917<tr><td valign=top><em>target</em>&nbsp;</td><td>
918The target part of the processing instruction. </td></tr>
919<tr><td valign=top><em>data</em>&nbsp;</td><td>
920The data for the node. </td></tr>
921</table>
922</dl><dl compact><dt><b>
923Returns: </b><dd>
924The new <code><a class="el" href="classDOMProcessingInstruction.html">DOMProcessingInstruction</a></code> object. </dl><dl compact><dt><b>
925Exceptions: </b><dd>
926<table border=0 cellspacing=2 cellpadding=0>
927<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
928 INVALID_CHARACTER_ERR: Raised if the specified target contains an illegal character. </td></tr>
929</table>
930</dl><dl compact><dt><b>
931Since: </b><dd>
932DOM Level 1 </dl>    </td>
933  </tr>
934</table>
935<a name="z28_2" doxytag="DOMDocument::createTextNode"></a><p>
936<table width="100%" cellpadding="2" cellspacing="0" border="0">
937  <tr>
938    <td class="md">
939      <table cellpadding="0" cellspacing="0" border="0">
940        <tr>
941          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMText.html">DOMText</a>* DOMDocument::createTextNode </td>
942          <td class="md" valign="top">(&nbsp;</td>
943          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
944          <td class="mdname1" valign="top" nowrap>&nbsp; <em>data</em>          </td>
945          <td class="md" valign="top">)&nbsp;</td>
946          <td class="md" nowrap><code> [pure virtual]</code></td>
947        </tr>
948
949      </table>
950    </td>
951  </tr>
952</table>
953<table cellspacing=5 cellpadding=0 border=0>
954  <tr>
955    <td>
956      &nbsp;
957    </td>
958    <td>
959
960<p>
961Creates a <code><a class="el" href="classDOMText.html">DOMText</a></code> node given the specified string.
962<p>
963<dl compact><dt><b>
964Parameters: </b><dd>
965<table border=0 cellspacing=2 cellpadding=0>
966<tr><td valign=top><em>data</em>&nbsp;</td><td>
967The data for the node. </td></tr>
968</table>
969</dl><dl compact><dt><b>
970Returns: </b><dd>
971The new <code><a class="el" href="classDOMText.html">DOMText</a></code> object. </dl><dl compact><dt><b>
972Since: </b><dd>
973DOM Level 1 </dl>    </td>
974  </tr>
975</table>
976<a name="z30_0" doxytag="DOMDocument::getActualEncoding"></a><p>
977<table width="100%" cellpadding="2" cellspacing="0" border="0">
978  <tr>
979    <td class="md">
980      <table cellpadding="0" cellspacing="0" border="0">
981        <tr>
982          <td class="md" nowrap valign="top"> virtual const XMLCh* DOMDocument::getActualEncoding </td>
983          <td class="md" valign="top">(&nbsp;</td>
984          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
985          <td class="md" valign="top">)&nbsp;</td>
986          <td class="md" nowrap> const<code> [pure virtual]</code></td>
987        </tr>
988
989      </table>
990    </td>
991  </tr>
992</table>
993<table cellspacing=5 cellpadding=0 border=0>
994  <tr>
995    <td>
996      &nbsp;
997    </td>
998    <td>
999
1000<p>
1001An attribute specifying the actual encoding of this document.
1002<p>
1003This is <code>null</code> otherwise. <br>
1004 This attribute represents the property [character encoding scheme] defined in.
1005<p>
1006
1007<p>
1008<b>"Experimental - subject to change"</b>
1009<p>
1010<dl compact><dt><b>
1011Since: </b><dd>
1012DOM Level 3 </dl>    </td>
1013  </tr>
1014</table>
1015<a name="z28_8" doxytag="DOMDocument::getDoctype"></a><p>
1016<table width="100%" cellpadding="2" cellspacing="0" border="0">
1017  <tr>
1018    <td class="md">
1019      <table cellpadding="0" cellspacing="0" border="0">
1020        <tr>
1021          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMDocumentType.html">DOMDocumentType</a>* DOMDocument::getDoctype </td>
1022          <td class="md" valign="top">(&nbsp;</td>
1023          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1024          <td class="md" valign="top">)&nbsp;</td>
1025          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1026        </tr>
1027
1028      </table>
1029    </td>
1030  </tr>
1031</table>
1032<table cellspacing=5 cellpadding=0 border=0>
1033  <tr>
1034    <td>
1035      &nbsp;
1036    </td>
1037    <td>
1038
1039<p>
1040The Document Type Declaration (see <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code>) associated with this document.
1041<p>
1042For XML documents without a document type declaration this returns <code>null</code>. The DOM Level 2 does not support editing the Document Type Declaration. <code>docType</code> cannot be altered in any way, including through the use of methods inherited from the <code><a class="el" href="classDOMNode.html">DOMNode</a></code> interface, such as <code>insertNode</code> or <code>removeNode</code>. <dl compact><dt><b>
1043Since: </b><dd>
1044DOM Level 1 </dl>    </td>
1045  </tr>
1046</table>
1047<a name="z28_10" doxytag="DOMDocument::getDocumentElement"></a><p>
1048<table width="100%" cellpadding="2" cellspacing="0" border="0">
1049  <tr>
1050    <td class="md">
1051      <table cellpadding="0" cellspacing="0" border="0">
1052        <tr>
1053          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMElement.html">DOMElement</a>* DOMDocument::getDocumentElement </td>
1054          <td class="md" valign="top">(&nbsp;</td>
1055          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1056          <td class="md" valign="top">)&nbsp;</td>
1057          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1058        </tr>
1059
1060      </table>
1061    </td>
1062  </tr>
1063</table>
1064<table cellspacing=5 cellpadding=0 border=0>
1065  <tr>
1066    <td>
1067      &nbsp;
1068    </td>
1069    <td>
1070
1071<p>
1072This is a convenience attribute that allows direct access to the child node that is the root element of the document.
1073<p>
1074<dl compact><dt><b>
1075Since: </b><dd>
1076DOM Level 1 </dl>    </td>
1077  </tr>
1078</table>
1079<a name="z30_8" doxytag="DOMDocument::getDocumentURI"></a><p>
1080<table width="100%" cellpadding="2" cellspacing="0" border="0">
1081  <tr>
1082    <td class="md">
1083      <table cellpadding="0" cellspacing="0" border="0">
1084        <tr>
1085          <td class="md" nowrap valign="top"> virtual const XMLCh* DOMDocument::getDocumentURI </td>
1086          <td class="md" valign="top">(&nbsp;</td>
1087          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1088          <td class="md" valign="top">)&nbsp;</td>
1089          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1090        </tr>
1091
1092      </table>
1093    </td>
1094  </tr>
1095</table>
1096<table cellspacing=5 cellpadding=0 border=0>
1097  <tr>
1098    <td>
1099      &nbsp;
1100    </td>
1101    <td>
1102
1103<p>
1104The location of the document or <code>null</code> if undefined.
1105<p>
1106<br>
1107Beware that when the <code>DOMDocument</code> supports the feature "HTML" , the href attribute of the HTML BASE element takes precedence over this attribute.
1108<p>
1109
1110<p>
1111<b>"Experimental - subject to change"</b>
1112<p>
1113<dl compact><dt><b>
1114Since: </b><dd>
1115DOM Level 3 </dl>    </td>
1116  </tr>
1117</table>
1118<a name="z30_15" doxytag="DOMDocument::getDOMConfiguration"></a><p>
1119<table width="100%" cellpadding="2" cellspacing="0" border="0">
1120  <tr>
1121    <td class="md">
1122      <table cellpadding="0" cellspacing="0" border="0">
1123        <tr>
1124          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMConfiguration.html">DOMConfiguration</a>* DOMDocument::getDOMConfiguration </td>
1125          <td class="md" valign="top">(&nbsp;</td>
1126          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1127          <td class="md" valign="top">)&nbsp;</td>
1128          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1129        </tr>
1130
1131      </table>
1132    </td>
1133  </tr>
1134</table>
1135<table cellspacing=5 cellpadding=0 border=0>
1136  <tr>
1137    <td>
1138      &nbsp;
1139    </td>
1140    <td>
1141
1142<p>
1143The configuration used when Document.normalizeDocument is invoked.
1144<p>
1145<dl compact><dt><b>
1146Returns: </b><dd>
1147The <code><a class="el" href="classDOMConfiguration.html">DOMConfiguration</a></code> from this <code>DOMDocument</code></dl>Note that this is a partial implementation. Not all the required features are  implemented and this is only used by normalizeDocument. Currently <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> and <code><a class="el" href="classDOMText.html">DOMText</a></code> nodes are normalized.  Features to remove <code><a class="el" href="classDOMComment.html">DOMComment</a></code> and <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> work. The feature to normalize namespaces is implemented. This feature is called  "namespaces" and is incorectly documented in the current WD.
1148<p>
1149
1150<p>
1151<b>"Experimental - subject to change"</b> <dl compact><dt><b>
1152Since: </b><dd>
1153DOM Level 3 </dl>    </td>
1154  </tr>
1155</table>
1156<a name="z29_4" doxytag="DOMDocument::getElementById"></a><p>
1157<table width="100%" cellpadding="2" cellspacing="0" border="0">
1158  <tr>
1159    <td class="md">
1160      <table cellpadding="0" cellspacing="0" border="0">
1161        <tr>
1162          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMElement.html">DOMElement</a>* DOMDocument::getElementById </td>
1163          <td class="md" valign="top">(&nbsp;</td>
1164          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1165          <td class="mdname1" valign="top" nowrap>&nbsp; <em>elementId</em>          </td>
1166          <td class="md" valign="top">)&nbsp;</td>
1167          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1168        </tr>
1169
1170      </table>
1171    </td>
1172  </tr>
1173</table>
1174<table cellspacing=5 cellpadding=0 border=0>
1175  <tr>
1176    <td>
1177      &nbsp;
1178    </td>
1179    <td>
1180
1181<p>
1182Returns the <code><a class="el" href="classDOMElement.html">DOMElement</a></code> whose <code>ID</code> is given by <code>elementId</code>.
1183<p>
1184If no such element exists, returns <code>null</code>. Behavior is not defined if more than one element has this <code>ID</code>. The DOM implementation must have information that says which attributes are of type ID. <a class="el" href="classAttributes.html">Attributes</a> with the name "ID" are not of type ID unless so defined. Implementations that do not know whether attributes are of type ID or not are expected to return <code>null</code>. <dl compact><dt><b>
1185Parameters: </b><dd>
1186<table border=0 cellspacing=2 cellpadding=0>
1187<tr><td valign=top><em>elementId</em>&nbsp;</td><td>
1188The unique <code>id</code> value for an element. </td></tr>
1189</table>
1190</dl><dl compact><dt><b>
1191Returns: </b><dd>
1192The matching element. </dl><dl compact><dt><b>
1193Since: </b><dd>
1194DOM Level 2 </dl>    </td>
1195  </tr>
1196</table>
1197<a name="z28_11" doxytag="DOMDocument::getElementsByTagName"></a><p>
1198<table width="100%" cellpadding="2" cellspacing="0" border="0">
1199  <tr>
1200    <td class="md">
1201      <table cellpadding="0" cellspacing="0" border="0">
1202        <tr>
1203          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNodeList.html">DOMNodeList</a>* DOMDocument::getElementsByTagName </td>
1204          <td class="md" valign="top">(&nbsp;</td>
1205          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1206          <td class="mdname1" valign="top" nowrap>&nbsp; <em>tagname</em>          </td>
1207          <td class="md" valign="top">)&nbsp;</td>
1208          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1209        </tr>
1210
1211      </table>
1212    </td>
1213  </tr>
1214</table>
1215<table cellspacing=5 cellpadding=0 border=0>
1216  <tr>
1217    <td>
1218      &nbsp;
1219    </td>
1220    <td>
1221
1222<p>
1223Returns a <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> of all the <code>DOMElement(s)</code> with a given tag name in the order in which they are encountered in a preorder traversal of the <code>DOMDocument</code> tree.
1224<p>
1225The returned node list is "live", in that changes to the document tree made after a nodelist was initially returned will be immediately reflected in the node list. <dl compact><dt><b>
1226Parameters: </b><dd>
1227<table border=0 cellspacing=2 cellpadding=0>
1228<tr><td valign=top><em>tagname</em>&nbsp;</td><td>
1229The name of the tag to match on. The special value "*" matches all tags. </td></tr>
1230</table>
1231</dl><dl compact><dt><b>
1232Returns: </b><dd>
1233A new <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> object containing all the matched <code>DOMElement(s)</code>. </dl><dl compact><dt><b>
1234Since: </b><dd>
1235DOM Level 1 </dl>    </td>
1236  </tr>
1237</table>
1238<a name="z29_3" doxytag="DOMDocument::getElementsByTagNameNS"></a><p>
1239<table width="100%" cellpadding="2" cellspacing="0" border="0">
1240  <tr>
1241    <td class="md">
1242      <table cellpadding="0" cellspacing="0" border="0">
1243        <tr>
1244          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNodeList.html">DOMNodeList</a>* DOMDocument::getElementsByTagNameNS </td>
1245          <td class="md" valign="top">(&nbsp;</td>
1246          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1247          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
1248        </tr>
1249        <tr>
1250          <td></td>
1251          <td></td>
1252          <td class="md" nowrap>const XMLCh *&nbsp;</td>
1253          <td class="mdname" nowrap>&nbsp; <em>localName</em></td>
1254        </tr>
1255        <tr>
1256          <td></td>
1257          <td class="md">)&nbsp;</td>
1258          <td class="md" colspan="2"> const<code> [pure virtual]</code></td>
1259        </tr>
1260
1261      </table>
1262    </td>
1263  </tr>
1264</table>
1265<table cellspacing=5 cellpadding=0 border=0>
1266  <tr>
1267    <td>
1268      &nbsp;
1269    </td>
1270    <td>
1271
1272<p>
1273Returns a <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> of all the <code>DOMElement(s)</code> with a given local name and namespace URI in the order in which they are encountered in a preorder traversal of the <code>DOMDocument</code> tree.
1274<p>
1275<dl compact><dt><b>
1276Parameters: </b><dd>
1277<table border=0 cellspacing=2 cellpadding=0>
1278<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
1279The namespace URI of the elements to match on. The special value "*" matches all namespaces. </td></tr>
1280<tr><td valign=top><em>localName</em>&nbsp;</td><td>
1281The local name of the elements to match on. The special value "*" matches all local names. </td></tr>
1282</table>
1283</dl><dl compact><dt><b>
1284Returns: </b><dd>
1285A new <code><a class="el" href="classDOMNodeList.html">DOMNodeList</a></code> object containing all the matched <code>DOMElement(s)</code>. </dl><dl compact><dt><b>
1286Since: </b><dd>
1287DOM Level 2 </dl>    </td>
1288  </tr>
1289</table>
1290<a name="z30_2" doxytag="DOMDocument::getEncoding"></a><p>
1291<table width="100%" cellpadding="2" cellspacing="0" border="0">
1292  <tr>
1293    <td class="md">
1294      <table cellpadding="0" cellspacing="0" border="0">
1295        <tr>
1296          <td class="md" nowrap valign="top"> virtual const XMLCh* DOMDocument::getEncoding </td>
1297          <td class="md" valign="top">(&nbsp;</td>
1298          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1299          <td class="md" valign="top">)&nbsp;</td>
1300          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1301        </tr>
1302
1303      </table>
1304    </td>
1305  </tr>
1306</table>
1307<table cellspacing=5 cellpadding=0 border=0>
1308  <tr>
1309    <td>
1310      &nbsp;
1311    </td>
1312    <td>
1313
1314<p>
1315An attribute specifying, as part of the XML declaration, the encoding of this document.
1316<p>
1317This is <code>null</code> when unspecified.
1318<p>
1319
1320<p>
1321<b>"Experimental - subject to change"</b>
1322<p>
1323<dl compact><dt><b>
1324Since: </b><dd>
1325DOM Level 3 </dl>    </td>
1326  </tr>
1327</table>
1328<a name="z28_9" doxytag="DOMDocument::getImplementation"></a><p>
1329<table width="100%" cellpadding="2" cellspacing="0" border="0">
1330  <tr>
1331    <td class="md">
1332      <table cellpadding="0" cellspacing="0" border="0">
1333        <tr>
1334          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMImplementation.html">DOMImplementation</a>* DOMDocument::getImplementation </td>
1335          <td class="md" valign="top">(&nbsp;</td>
1336          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1337          <td class="md" valign="top">)&nbsp;</td>
1338          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1339        </tr>
1340
1341      </table>
1342    </td>
1343  </tr>
1344</table>
1345<table cellspacing=5 cellpadding=0 border=0>
1346  <tr>
1347    <td>
1348      &nbsp;
1349    </td>
1350    <td>
1351
1352<p>
1353The <code><a class="el" href="classDOMImplementation.html">DOMImplementation</a></code> object that handles this document.
1354<p>
1355A DOM application may use objects from multiple implementations. <dl compact><dt><b>
1356Since: </b><dd>
1357DOM Level 1 </dl>    </td>
1358  </tr>
1359</table>
1360<a name="z30_4" doxytag="DOMDocument::getStandalone"></a><p>
1361<table width="100%" cellpadding="2" cellspacing="0" border="0">
1362  <tr>
1363    <td class="md">
1364      <table cellpadding="0" cellspacing="0" border="0">
1365        <tr>
1366          <td class="md" nowrap valign="top"> virtual bool DOMDocument::getStandalone </td>
1367          <td class="md" valign="top">(&nbsp;</td>
1368          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1369          <td class="md" valign="top">)&nbsp;</td>
1370          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1371        </tr>
1372
1373      </table>
1374    </td>
1375  </tr>
1376</table>
1377<table cellspacing=5 cellpadding=0 border=0>
1378  <tr>
1379    <td>
1380      &nbsp;
1381    </td>
1382    <td>
1383
1384<p>
1385An attribute specifying, as part of the XML declaration, whether this document is standalone.
1386<p>
1387<br>
1388 This attribute represents the property [standalone] defined in .
1389<p>
1390
1391<p>
1392<b>"Experimental - subject to change"</b>
1393<p>
1394<dl compact><dt><b>
1395Since: </b><dd>
1396DOM Level 3 </dl>    </td>
1397  </tr>
1398</table>
1399<a name="z30_10" doxytag="DOMDocument::getStrictErrorChecking"></a><p>
1400<table width="100%" cellpadding="2" cellspacing="0" border="0">
1401  <tr>
1402    <td class="md">
1403      <table cellpadding="0" cellspacing="0" border="0">
1404        <tr>
1405          <td class="md" nowrap valign="top"> virtual bool DOMDocument::getStrictErrorChecking </td>
1406          <td class="md" valign="top">(&nbsp;</td>
1407          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1408          <td class="md" valign="top">)&nbsp;</td>
1409          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1410        </tr>
1411
1412      </table>
1413    </td>
1414  </tr>
1415</table>
1416<table cellspacing=5 cellpadding=0 border=0>
1417  <tr>
1418    <td>
1419      &nbsp;
1420    </td>
1421    <td>
1422
1423<p>
1424An attribute specifying whether errors checking is enforced or not.
1425<p>
1426When set to <code>false</code>, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise any <code><a class="el" href="classDOMException.html">DOMException</a></code>. In case of error, the behavior is undefined. This attribute is <code>true</code> by defaults.
1427<p>
1428
1429<p>
1430<b>"Experimental - subject to change"</b>
1431<p>
1432<dl compact><dt><b>
1433Since: </b><dd>
1434DOM Level 3 </dl>    </td>
1435  </tr>
1436</table>
1437<a name="z30_6" doxytag="DOMDocument::getVersion"></a><p>
1438<table width="100%" cellpadding="2" cellspacing="0" border="0">
1439  <tr>
1440    <td class="md">
1441      <table cellpadding="0" cellspacing="0" border="0">
1442        <tr>
1443          <td class="md" nowrap valign="top"> virtual const XMLCh* DOMDocument::getVersion </td>
1444          <td class="md" valign="top">(&nbsp;</td>
1445          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1446          <td class="md" valign="top">)&nbsp;</td>
1447          <td class="md" nowrap> const<code> [pure virtual]</code></td>
1448        </tr>
1449
1450      </table>
1451    </td>
1452  </tr>
1453</table>
1454<table cellspacing=5 cellpadding=0 border=0>
1455  <tr>
1456    <td>
1457      &nbsp;
1458    </td>
1459    <td>
1460
1461<p>
1462An attribute specifying, as part of the XML declaration, the version number of this document.
1463<p>
1464This is <code>null</code> when unspecified. <br>
1465 This attribute represents the property [version] defined in .
1466<p>
1467
1468<p>
1469<b>"Experimental - subject to change"</b>
1470<p>
1471<dl compact><dt><b>
1472Since: </b><dd>
1473DOM Level 3 </dl>    </td>
1474  </tr>
1475</table>
1476<a name="z29_0" doxytag="DOMDocument::importNode"></a><p>
1477<table width="100%" cellpadding="2" cellspacing="0" border="0">
1478  <tr>
1479    <td class="md">
1480      <table cellpadding="0" cellspacing="0" border="0">
1481        <tr>
1482          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMDocument::importNode </td>
1483          <td class="md" valign="top">(&nbsp;</td>
1484          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1485          <td class="mdname" nowrap>&nbsp; <em>importedNode</em>, </td>
1486        </tr>
1487        <tr>
1488          <td></td>
1489          <td></td>
1490          <td class="md" nowrap>bool&nbsp;</td>
1491          <td class="mdname" nowrap>&nbsp; <em>deep</em></td>
1492        </tr>
1493        <tr>
1494          <td></td>
1495          <td class="md">)&nbsp;</td>
1496          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1497        </tr>
1498
1499      </table>
1500    </td>
1501  </tr>
1502</table>
1503<table cellspacing=5 cellpadding=0 border=0>
1504  <tr>
1505    <td>
1506      &nbsp;
1507    </td>
1508    <td>
1509
1510<p>
1511Imports a node from another document to this document.
1512<p>
1513The returned node has no parent; (<code>parentNode</code> is <code>null</code>). The source node is not altered or removed from the original document; this method creates a new copy of the source node. <br>
1514For all nodes, importing a node creates a node object owned by the importing document, with attribute values identical to the source node's <code>nodeName</code> and <code>nodeType</code>, plus the attributes related to namespaces (<code>prefix</code>, <code>localName</code>, and <code>namespaceURI</code>). As in the <code>cloneNode</code> operation on a <code><a class="el" href="classDOMNode.html">DOMNode</a></code>, the source node is not altered. <br>
1515Additional information is copied as appropriate to the <code>nodeType</code>, attempting to mirror the behavior expected if a fragment of XML source was copied from one document to another, recognizing that the two documents may have different DTDs in the XML case. The following list describes the specifics for each type of node.
1516<dl compact>
1517 <dt>ATTRIBUTE_NODE <dd>The <code>ownerElement</code> attribute is set to <code>null</code> and the <code>specified</code> flag is set to <code>true</code> on the generated <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code>. The descendants of the source <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> are recursively imported and the resulting nodes reassembled to form the corresponding subtree. Note that the <code>deep</code> parameter has no effect on <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes; they always carry their children with them when imported. <dt>DOCUMENT_FRAGMENT_NODE <dd>If the <code>deep</code> option was set to <code>true</code>, the descendants of the source element are recursively imported and the resulting nodes reassembled to form the corresponding subtree. Otherwise, this simply generates an empty <code><a class="el" href="classDOMDocumentFragment.html">DOMDocumentFragment</a></code>. <dt>DOCUMENT_NODE <dd><code>DOMDocument</code> nodes cannot be imported. <dt>DOCUMENT_TYPE_NODE <dd><code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> nodes cannot be imported. <dt>ELEMENT_NODE <dd>Specified attribute nodes of the source element are imported, and the generated <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> nodes are attached to the generated <code><a class="el" href="classDOMElement.html">DOMElement</a></code>. Default attributes are not copied, though if the document being imported into defines default attributes for this element name, those are assigned. If the <code>importNode</code> <code>deep</code> parameter was set to <code>true</code>, the descendants of the source element are recursively imported and the resulting nodes reassembled to form the corresponding subtree. <dt>ENTITY_NODE <dd><code><a class="el" href="classDOMEntity.html">DOMEntity</a></code> nodes can be imported, however in the current release of the DOM the <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> is readonly. Ability to add these imported nodes to a <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> will be considered for addition to a future release of the DOM.On import, the <code>publicId</code>, <code>systemId</code>, and <code>notationName</code> attributes are copied. If a <code>deep</code> import is requested, the descendants of the the source <code><a class="el" href="classDOMEntity.html">DOMEntity</a></code> are recursively imported and the resulting nodes reassembled to form the corresponding subtree. <dt> ENTITY_REFERENCE_NODE <dd>Only the <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> itself is copied, even if a <code>deep</code> import is requested, since the source and destination documents might have defined the entity differently. If the document being imported into provides a definition for this entity name, its value is assigned. <dt>NOTATION_NODE <dd> <code><a class="el" href="classDOMNotation.html">DOMNotation</a></code> nodes can be imported, however in the current release of the DOM the <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> is readonly. Ability to add these imported nodes to a <code><a class="el" href="classDOMDocumentType.html">DOMDocumentType</a></code> will be considered for addition to a future release of the DOM.On import, the <code>publicId</code> and <code>systemId</code> attributes are copied. Note that the <code>deep</code> parameter has no effect on <code><a class="el" href="classDOMNotation.html">DOMNotation</a></code> nodes since they never have any children. <dt> PROCESSING_INSTRUCTION_NODE <dd>The imported node copies its <code>target</code> and <code>data</code> values from those of the source node. <dt>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE <dd>These three types of nodes inheriting from <code><a class="el" href="classDOMCharacterData.html">DOMCharacterData</a></code> copy their <code>data</code> and <code>length</code> attributes from those of the source node.
1518</dl>
1519 <dl compact><dt><b>
1520Parameters: </b><dd>
1521<table border=0 cellspacing=2 cellpadding=0>
1522<tr><td valign=top><em>importedNode</em>&nbsp;</td><td>
1523The node to import. </td></tr>
1524<tr><td valign=top><em>deep</em>&nbsp;</td><td>
1525If <code>true</code>, recursively import the subtree under the specified node; if <code>false</code>, import only the node itself, as explained above. This has no effect on <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> , <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code>, and <code><a class="el" href="classDOMNotation.html">DOMNotation</a></code> nodes. </td></tr>
1526</table>
1527</dl><dl compact><dt><b>
1528Returns: </b><dd>
1529The imported node that belongs to this <code>DOMDocument</code>. </dl><dl compact><dt><b>
1530Exceptions: </b><dd>
1531<table border=0 cellspacing=2 cellpadding=0>
1532<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1533 NOT_SUPPORTED_ERR: Raised if the type of node being imported is not supported. </td></tr>
1534</table>
1535</dl><dl compact><dt><b>
1536Since: </b><dd>
1537DOM Level 2 </dl>    </td>
1538  </tr>
1539</table>
1540<a name="z30_14" doxytag="DOMDocument::normalizeDocument"></a><p>
1541<table width="100%" cellpadding="2" cellspacing="0" border="0">
1542  <tr>
1543    <td class="md">
1544      <table cellpadding="0" cellspacing="0" border="0">
1545        <tr>
1546          <td class="md" nowrap valign="top"> virtual void DOMDocument::normalizeDocument </td>
1547          <td class="md" valign="top">(&nbsp;</td>
1548          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
1549          <td class="md" valign="top">)&nbsp;</td>
1550          <td class="md" nowrap><code> [pure virtual]</code></td>
1551        </tr>
1552
1553      </table>
1554    </td>
1555  </tr>
1556</table>
1557<table cellspacing=5 cellpadding=0 border=0>
1558  <tr>
1559    <td>
1560      &nbsp;
1561    </td>
1562    <td>
1563
1564<p>
1565This method acts as if the document was going through a save and load cycle, putting the document in a "normal" form.
1566<p>
1567The actual result depends on the features being set. See <code><a class="el" href="classDOMConfiguration.html">DOMConfiguration</a></code> for  details.
1568<p>
1569
1570<p>
1571<b>"Experimental - subject to change"</b>
1572<p>
1573<br>
1574Noticeably this method normalizes <code><a class="el" href="classDOMText.html">DOMText</a></code> nodes, makes the document "namespace wellformed", according to the algorithm described below in pseudo code, by adding missing namespace declaration attributes and adding or changing namespace prefixes, updates the replacement tree of <code><a class="el" href="classDOMEntityReference.html">DOMEntityReference</a></code> nodes, normalizes attribute values, etc. <br>
1575Mutation events, when supported, are generated to reflect the changes occuring on the document. Note that this is a partial implementation. Not all the required features are implemented. Currently <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> and <code><a class="el" href="classDOMText.html">DOMText</a></code> nodes are normalized.  Features to remove <code><a class="el" href="classDOMComment.html">DOMComment</a></code> and <code><a class="el" href="classDOMCDATASection.html">DOMCDATASection</a></code> work. The feature to normalize namespaces is implemented. This feature is called  "namespaces" and is incorectly documented in the current WD. <dl compact><dt><b>
1576Since: </b><dd>
1577DOM Level 3 </dl>    </td>
1578  </tr>
1579</table>
1580<a name="z30_12" doxytag="DOMDocument::renameNode"></a><p>
1581<table width="100%" cellpadding="2" cellspacing="0" border="0">
1582  <tr>
1583    <td class="md">
1584      <table cellpadding="0" cellspacing="0" border="0">
1585        <tr>
1586          <td class="md" nowrap valign="top"> virtual <a class="el" href="classDOMNode.html">DOMNode</a>* DOMDocument::renameNode </td>
1587          <td class="md" valign="top">(&nbsp;</td>
1588          <td class="md" nowrap valign="top"><a class="el" href="classDOMNode.html">DOMNode</a> *&nbsp;</td>
1589          <td class="mdname" nowrap>&nbsp; <em>n</em>, </td>
1590        </tr>
1591        <tr>
1592          <td></td>
1593          <td></td>
1594          <td class="md" nowrap>const XMLCh *&nbsp;</td>
1595          <td class="mdname" nowrap>&nbsp; <em>namespaceURI</em>, </td>
1596        </tr>
1597        <tr>
1598          <td></td>
1599          <td></td>
1600          <td class="md" nowrap>const XMLCh *&nbsp;</td>
1601          <td class="mdname" nowrap>&nbsp; <em>name</em></td>
1602        </tr>
1603        <tr>
1604          <td></td>
1605          <td class="md">)&nbsp;</td>
1606          <td class="md" colspan="2"><code> [pure virtual]</code></td>
1607        </tr>
1608
1609      </table>
1610    </td>
1611  </tr>
1612</table>
1613<table cellspacing=5 cellpadding=0 border=0>
1614  <tr>
1615    <td>
1616      &nbsp;
1617    </td>
1618    <td>
1619
1620<p>
1621Rename an existing node.
1622<p>
1623When possible this simply changes the name of the given node, otherwise this creates a new node with the specified name and replaces the existing node with the new node as described below. This only applies to nodes of type <code>ELEMENT_NODE</code> and <code>ATTRIBUTE_NODE</code>. <br>
1624When a new node is created, the following operations are performed: the new node is created, any registered event listener is registered on the new node, any user data attached to the old node is removed from that node, the old node is removed from its parent if it has one, the children are moved to the new node, if the renamed node is an <code><a class="el" href="classDOMElement.html">DOMElement</a></code> its attributes are moved to the new node, the new node is inserted at the position the old node used to have in its parent's child nodes list if it has one, the user data that was attached to the old node is attach to the new node, the user data event <code>NODE_RENAMED</code> is fired. <br>
1625When the node being renamed is an <code><a class="el" href="classDOMAttr.html">DOMAttr</a></code> that is attached to an <code><a class="el" href="classDOMElement.html">DOMElement</a></code>, the node is first removed from the <code><a class="el" href="classDOMElement.html">DOMElement</a></code> attributes map. Then, once renamed, either by modifying the existing node or creating a new one as described above, it is put back.
1626<p>
1627
1628<p>
1629<b>"Experimental - subject to change"</b><dl compact><dt><b>
1630Parameters: </b><dd>
1631<table border=0 cellspacing=2 cellpadding=0>
1632<tr><td valign=top><em>n</em>&nbsp;</td><td>
1633The node to rename. </td></tr>
1634<tr><td valign=top><em>namespaceURI</em>&nbsp;</td><td>
1635The new namespaceURI. </td></tr>
1636<tr><td valign=top><em>name</em>&nbsp;</td><td>
1637The new qualified name. </td></tr>
1638</table>
1639</dl><dl compact><dt><b>
1640Returns: </b><dd>
1641The renamed node. This is either the specified node or the new node that was created to replace the specified node. </dl><dl compact><dt><b>
1642Exceptions: </b><dd>
1643<table border=0 cellspacing=2 cellpadding=0>
1644<tr><td valign=top><em><a class="el" href="classDOMException.html">DOMException</a></em>&nbsp;</td><td>
1645 NOT_SUPPORTED_ERR: Raised when the type of the specified node is neither <code>ELEMENT_NODE</code> nor <code>ATTRIBUTE_NODE</code>. <br>
1646WRONG_DOCUMENT_ERR: Raised when the specified node was created from a different document than this document. <br>
1647NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is malformed per the Namespaces in XML specification, if the <code>qualifiedName</code> has a prefix and the <code>namespaceURI</code> is <code>null</code>, or if the <code>qualifiedName</code> has a prefix that is "xml" and the <code>namespaceURI</code> is different from " <a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a>" . Also raised, when the node being renamed is an attribute, if the <code>qualifiedName</code>, or its prefix, is "xmlns" and the <code>namespaceURI</code> is different from "<a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a>". </td></tr>
1648</table>
1649</dl><dl compact><dt><b>
1650Since: </b><dd>
1651DOM Level 3 </dl>    </td>
1652  </tr>
1653</table>
1654<a name="z30_1" doxytag="DOMDocument::setActualEncoding"></a><p>
1655<table width="100%" cellpadding="2" cellspacing="0" border="0">
1656  <tr>
1657    <td class="md">
1658      <table cellpadding="0" cellspacing="0" border="0">
1659        <tr>
1660          <td class="md" nowrap valign="top"> virtual void DOMDocument::setActualEncoding </td>
1661          <td class="md" valign="top">(&nbsp;</td>
1662          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1663          <td class="mdname1" valign="top" nowrap>&nbsp; <em>actualEncoding</em>          </td>
1664          <td class="md" valign="top">)&nbsp;</td>
1665          <td class="md" nowrap><code> [pure virtual]</code></td>
1666        </tr>
1667
1668      </table>
1669    </td>
1670  </tr>
1671</table>
1672<table cellspacing=5 cellpadding=0 border=0>
1673  <tr>
1674    <td>
1675      &nbsp;
1676    </td>
1677    <td>
1678
1679<p>
1680An attribute specifying the actual encoding of this document.
1681<p>
1682This is <code>null</code> otherwise. <br>
1683 This attribute represents the property [character encoding scheme] defined in .
1684<p>
1685
1686<p>
1687<b>"Experimental - subject to change"</b>
1688<p>
1689<dl compact><dt><b>
1690Since: </b><dd>
1691DOM Level 3 </dl>    </td>
1692  </tr>
1693</table>
1694<a name="z30_9" doxytag="DOMDocument::setDocumentURI"></a><p>
1695<table width="100%" cellpadding="2" cellspacing="0" border="0">
1696  <tr>
1697    <td class="md">
1698      <table cellpadding="0" cellspacing="0" border="0">
1699        <tr>
1700          <td class="md" nowrap valign="top"> virtual void DOMDocument::setDocumentURI </td>
1701          <td class="md" valign="top">(&nbsp;</td>
1702          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1703          <td class="mdname1" valign="top" nowrap>&nbsp; <em>documentURI</em>          </td>
1704          <td class="md" valign="top">)&nbsp;</td>
1705          <td class="md" nowrap><code> [pure virtual]</code></td>
1706        </tr>
1707
1708      </table>
1709    </td>
1710  </tr>
1711</table>
1712<table cellspacing=5 cellpadding=0 border=0>
1713  <tr>
1714    <td>
1715      &nbsp;
1716    </td>
1717    <td>
1718
1719<p>
1720The location of the document or <code>null</code> if undefined.
1721<p>
1722<br>
1723Beware that when the <code>DOMDocument</code> supports the feature "HTML" , the href attribute of the HTML BASE element takes precedence over this attribute.
1724<p>
1725
1726<p>
1727<b>"Experimental - subject to change"</b>
1728<p>
1729<dl compact><dt><b>
1730Since: </b><dd>
1731DOM Level 3 </dl>    </td>
1732  </tr>
1733</table>
1734<a name="z30_3" doxytag="DOMDocument::setEncoding"></a><p>
1735<table width="100%" cellpadding="2" cellspacing="0" border="0">
1736  <tr>
1737    <td class="md">
1738      <table cellpadding="0" cellspacing="0" border="0">
1739        <tr>
1740          <td class="md" nowrap valign="top"> virtual void DOMDocument::setEncoding </td>
1741          <td class="md" valign="top">(&nbsp;</td>
1742          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1743          <td class="mdname1" valign="top" nowrap>&nbsp; <em>encoding</em>          </td>
1744          <td class="md" valign="top">)&nbsp;</td>
1745          <td class="md" nowrap><code> [pure virtual]</code></td>
1746        </tr>
1747
1748      </table>
1749    </td>
1750  </tr>
1751</table>
1752<table cellspacing=5 cellpadding=0 border=0>
1753  <tr>
1754    <td>
1755      &nbsp;
1756    </td>
1757    <td>
1758
1759<p>
1760An attribute specifying, as part of the XML declaration, the encoding of this document.
1761<p>
1762This is <code>null</code> when unspecified.
1763<p>
1764
1765<p>
1766<b>"Experimental - subject to change"</b>
1767<p>
1768<dl compact><dt><b>
1769Since: </b><dd>
1770DOM Level 3 </dl>    </td>
1771  </tr>
1772</table>
1773<a name="z30_5" doxytag="DOMDocument::setStandalone"></a><p>
1774<table width="100%" cellpadding="2" cellspacing="0" border="0">
1775  <tr>
1776    <td class="md">
1777      <table cellpadding="0" cellspacing="0" border="0">
1778        <tr>
1779          <td class="md" nowrap valign="top"> virtual void DOMDocument::setStandalone </td>
1780          <td class="md" valign="top">(&nbsp;</td>
1781          <td class="md" nowrap valign="top">bool&nbsp;</td>
1782          <td class="mdname1" valign="top" nowrap>&nbsp; <em>standalone</em>          </td>
1783          <td class="md" valign="top">)&nbsp;</td>
1784          <td class="md" nowrap><code> [pure virtual]</code></td>
1785        </tr>
1786
1787      </table>
1788    </td>
1789  </tr>
1790</table>
1791<table cellspacing=5 cellpadding=0 border=0>
1792  <tr>
1793    <td>
1794      &nbsp;
1795    </td>
1796    <td>
1797
1798<p>
1799An attribute specifying, as part of the XML declaration, whether this document is standalone.
1800<p>
1801<br>
1802 This attribute represents the property [standalone] defined in .
1803<p>
1804
1805<p>
1806<b>"Experimental - subject to change"</b>
1807<p>
1808<dl compact><dt><b>
1809Since: </b><dd>
1810DOM Level 3 </dl>    </td>
1811  </tr>
1812</table>
1813<a name="z30_11" doxytag="DOMDocument::setStrictErrorChecking"></a><p>
1814<table width="100%" cellpadding="2" cellspacing="0" border="0">
1815  <tr>
1816    <td class="md">
1817      <table cellpadding="0" cellspacing="0" border="0">
1818        <tr>
1819          <td class="md" nowrap valign="top"> virtual void DOMDocument::setStrictErrorChecking </td>
1820          <td class="md" valign="top">(&nbsp;</td>
1821          <td class="md" nowrap valign="top">bool&nbsp;</td>
1822          <td class="mdname1" valign="top" nowrap>&nbsp; <em>strictErrorChecking</em>          </td>
1823          <td class="md" valign="top">)&nbsp;</td>
1824          <td class="md" nowrap><code> [pure virtual]</code></td>
1825        </tr>
1826
1827      </table>
1828    </td>
1829  </tr>
1830</table>
1831<table cellspacing=5 cellpadding=0 border=0>
1832  <tr>
1833    <td>
1834      &nbsp;
1835    </td>
1836    <td>
1837
1838<p>
1839An attribute specifying whether errors checking is enforced or not.
1840<p>
1841When set to <code>false</code>, the implementation is free to not test every possible error case normally defined on DOM operations, and not raise any <code><a class="el" href="classDOMException.html">DOMException</a></code>. In case of error, the behavior is undefined. This attribute is <code>true</code> by defaults.
1842<p>
1843
1844<p>
1845<b>"Experimental - subject to change"</b>
1846<p>
1847<dl compact><dt><b>
1848Since: </b><dd>
1849DOM Level 3 </dl>    </td>
1850  </tr>
1851</table>
1852<a name="z30_7" doxytag="DOMDocument::setVersion"></a><p>
1853<table width="100%" cellpadding="2" cellspacing="0" border="0">
1854  <tr>
1855    <td class="md">
1856      <table cellpadding="0" cellspacing="0" border="0">
1857        <tr>
1858          <td class="md" nowrap valign="top"> virtual void DOMDocument::setVersion </td>
1859          <td class="md" valign="top">(&nbsp;</td>
1860          <td class="md" nowrap valign="top">const XMLCh *&nbsp;</td>
1861          <td class="mdname1" valign="top" nowrap>&nbsp; <em>version</em>          </td>
1862          <td class="md" valign="top">)&nbsp;</td>
1863          <td class="md" nowrap><code> [pure virtual]</code></td>
1864        </tr>
1865
1866      </table>
1867    </td>
1868  </tr>
1869</table>
1870<table cellspacing=5 cellpadding=0 border=0>
1871  <tr>
1872    <td>
1873      &nbsp;
1874    </td>
1875    <td>
1876
1877<p>
1878An attribute specifying, as part of the XML declaration, the version number of this document.
1879<p>
1880This is <code>null</code> when unspecified. <br>
1881 This attribute represents the property [version] defined in .
1882<p>
1883
1884<p>
1885<b>"Experimental - subject to change"</b>
1886<p>
1887<dl compact><dt><b>
1888Since: </b><dd>
1889DOM Level 3 </dl>    </td>
1890  </tr>
1891</table>
1892<hr>The documentation for this class was generated from the following file:<ul>
1893<li><a class="el" href="DOMDocument_8hpp-source.html">DOMDocument.hpp</a></ul>
1894    </FONT></TD></TR></TABLE><BR>
1895</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>
1896              Copyright &copy; 1994-2004 The Apache Software Foundation.
1897              All Rights Reserved.
1898            </I></FONT></TD></TR></TABLE></BODY></HTML>
Note: See TracBrowser for help on using the repository browser.