XML::DO...eference(3)

🦋 NAME 🦋

Okay bestie, this is the manual page for XML::DOM::EntityReference — an XML ENTITY reference in XML::DOM 💅. It lives under the XML::DO...eference(3) title in the User Contributed Perl Documentation, and we are so ready.

✨ DESCRIPTION ✨

XML::DOM::EntityReference extends XML::DOM::Node. That's the family tree, no cap.

Now the actual lore: 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. Periodt.

Small but important note: 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. The processor is doing its little transformation arc.

Also, the XML processor may completely expand references to entities while building the structure model, instead of providing EntityReference objects. So sometimes you just don't get the object, and that's the processor's choice.

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. Conditional queen behavior.

As with the Entity node, all descendants of the EntityReference are readonly. Do not try to edit them, bestie — that's not the vibe. 🚫

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. So it's lowkey doing the work when you poke it. 👀

---

That's the whole page, bestie. This iconic little manual page is XML::DO...eference(3), brought to you by perl v5.42.0 and dated 2022-05-23. Slay. 💖