phpman > perldoc > XML::DOM::EntityReference

NAME
    XML::DOM::EntityReference - An XML ENTITY reference in XML::DOM

DESCRIPTION
    XML::DOM::EntityReference extends XML::DOM::Node.

    EntityReference 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 EntityReference objects. If it does provide
    such objects, then for a given EntityReference node, it may be that there is no Entity node
    representing the referenced entity; but if such an Entity exists, then the child list of the
    EntityReference node is the same as that of the Entity node. As with the Entity node, all
    descendants of the EntityReference are readonly.

    The resolution of the children of the EntityReference (the replacement value of the referenced
    Entity) may be lazily evaluated; actions by the user (such as calling the childNodes method on
    the EntityReference node) are assumed to trigger the evaluation.