XML::DOM::Entity(3)

💖 XML::DOM::Entity 💖

Okay bestie, welcome to the XML::DOM::Entity(3) manual page — this is the one about an XML ENTITY in XML::DOM, and it’s lowkey iconic for anyone deep in DOM node lore 🦋

✨ NAME ✨

XML::DOM::Entity — an XML ENTITY in XML::DOM 💅

🌸 DESCRIPTION 🌸

XML::DOM::Entity extends XML::DOM::Node. No cap, that’s the whole glow-up.

This node represents an Entity declaration, e.g.:

<!ENTITY % draft 'INCLUDE'>

<!ENTITY hatch-pic SYSTEM "../grafix/OpenHatch.gif" NDATA gif>

The first one is called a parameter entity and is referenced like this: %draft; The 2nd is a (regular) entity and is referenced like this: &hatch-pic; ✨

🎀 METHODS 🎀

getNotationName

Returns the name of the notation for the entity.

Not Implemented. The DOM Spec says: For unparsed entities, the name of the notation for the entity. For parsed entities, this is null. (This implementation does not support unparsed entities.) 😭

getSysId

Returns the system id, or undef.

getPubId

Returns the public id, or undef.

🫶 Additional methods not in the DOM Spec 🫶

isParameterEntity

Whether it is a parameter entity (%ent;) or not (&ent;) 👑

getValue

Returns the entity value.

getNdata

Returns the NDATA declaration (for general unparsed entities), or undef.

---

This gorgeous lil page is from perl v5.42.0, dated 2022-05-23, and it’s literally XML::DOM::Entity(3) — bye bestie, stay parsed 💜