1XML::DOM::EntityReferenUcsee(r3)Contributed Perl DocumenXtMaLt:i:oDnOM::EntityReference(3)
2
3
4
6 XML::DOM::EntityReference - An XML ENTITY reference in XML::DOM
7
9 XML::DOM::EntityReference extends XML::DOM::Node.
10
11 EntityReference objects may be inserted into the structure model when
12 an entity reference is in the source document, or when the user wishes
13 to insert an entity reference. Note that character references and ref‐
14 erences to predefined entities are considered to be expanded by the
15 HTML or XML processor so that characters are represented by their Uni‐
16 code equivalent rather than by an entity reference. Moreover, the XML
17 processor may completely expand references to entities while building
18 the structure model, instead of providing EntityReference objects. If
19 it does provide such objects, then for a given EntityReference node, it
20 may be that there is no Entity node representing the referenced entity;
21 but if such an Entity exists, then the child list of the EntityRefer‐
22 ence node is the same as that of the Entity node. As with the Entity
23 node, all descendants of the EntityReference are readonly.
24
25 The resolution of the children of the EntityReference (the replacement
26 value of the referenced Entity) may be lazily evaluated; actions by the
27 user (such as calling the childNodes method on the EntityReference
28 node) are assumed to trigger the evaluation.
29
30
31
32perl v5.8.8 2002-02-08 XML::DOM::EntityReference(3)