<h1>xercesc::DOMEntityReference Class Reference</h1><!-- doxytag: class="xercesc::DOMEntityReference" --><!-- doxytag: inherits="xercesc::DOMNode" --><code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> objects may be inserted into the structure model when an entity reference is in the source document, or when the user wishes to insert an entity reference.
<areashape="rect"href="classxercesc_1_1DOMNode.html"title="The DOMNode interface is the primary datatype for the entire Document Object Model..."alt=""coords="36,7,172,31"></map>
<code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> objects may be inserted into the structure model when an entity reference is in the source document, or when the user wishes to insert an entity reference.
Note that character references and references to predefined entities are considered to be expanded by the HTML or XML processor so that characters are represented by their Unicode equivalent rather than by an entity reference. Moreover, the XML processor may completely expand references to entities while building the structure model, instead of providing <code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> objects. If it does provide such objects, then for a given <code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> node, it may be that there is no <code><aclass="el"href="classxercesc_1_1DOMEntity.html"title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a></code> node representing the referenced entity. If such an <code><aclass="el"href="classxercesc_1_1DOMEntity.html"title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a></code> exists, then the subtree of the <code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> node is in general a copy of the <code><aclass="el"href="classxercesc_1_1DOMEntity.html"title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a></code> node subtree. However, this may not be true when an entity contains an unbound namespace prefix. In such a case, because the namespace prefix resolution depends on where the entity reference is, the descendants of the <code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> node may be bound to different namespace URIs. <p>
As for <code><aclass="el"href="classxercesc_1_1DOMEntity.html"title="This interface represents an entity, either parsed or unparsed, in an XML document...">DOMEntity</a></code> nodes, <code><aclass="el"href="classxercesc_1_1DOMEntityReference.html"title="DOMEntityReference objects may be inserted into the structure model when an entity...">DOMEntityReference</a></code> nodes and all their descendants are readonly. <p>
