\section{DOM::Entity\-Reference Class Reference}
\label{classDOM_1_1EntityReference}\index{DOM::EntityReference@{DOM::EntityReference}}
{\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} 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.  


{\tt \#include $<$dom\_\-xml.h$>$}

Inheritance diagram for DOM::Entity\-Reference:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=76pt]{classDOM_1_1EntityReference__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for DOM::Entity\-Reference:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=76pt]{classDOM_1_1EntityReference__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Entity\-Reference} (const {\bf Entity\-Reference} \&other)\label{classDOM_1_1EntityReference_a1}

\item 
{\bf Entity\-Reference} (const {\bf Node} \&other)\label{classDOM_1_1EntityReference_a2}

\item 
{\bf Entity\-Reference} \& {\bf operator=} (const {\bf Node} \&other)\label{classDOM_1_1EntityReference_a3}

\item 
{\bf Entity\-Reference} \& {\bf operator=} (const {\bf Entity\-Reference} \&other)\label{classDOM_1_1EntityReference_a4}

\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
{\bf Entity\-Reference} (Entity\-Reference\-Impl $\ast$i)\label{classDOM_1_1EntityReference_b0}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf Document}\label{classDOM_1_1EntityReference_n0}

\end{CompactItemize}


\subsection{Detailed Description}
{\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} 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 {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} objects. If it does provide such objects, then for a given {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} node, it may be that there is no {\tt {\bf Entity}{\rm (p.\,\pageref{classDOM_1_1Entity})}} node representing the referenced entity; but if such an {\tt {\bf Entity}{\rm (p.\,\pageref{classDOM_1_1Entity})}} exists, then the child list of the {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} node is the same as that of the {\tt {\bf Entity}{\rm (p.\,\pageref{classDOM_1_1Entity})}} node. As with the {\tt {\bf Entity}{\rm (p.\,\pageref{classDOM_1_1Entity})}} node, all descendants of the {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} are readonly.

The resolution of the children of the {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} (the replacement value of the referenced {\tt {\bf Entity}{\rm (p.\,\pageref{classDOM_1_1Entity})}} ) may be lazily evaluated; actions by the user (such as calling the {\tt child\-Nodes} method on the {\tt {\bf Entity\-Reference}{\rm (p.\,\pageref{classDOM_1_1EntityReference})}} node) are assumed to trigger the evaluation. 



Definition at line 188 of file dom\_\-xml.h.

The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
dom\_\-xml.h\item 
dom\_\-xml.cpp\end{CompactItemize}
