XML::E...ontent(3pm)

📦
version 0.014 · 8 versions
, in ubuntu stonking

💖 NAME 💖

XML::Easy::Content — the abstract form of XML content, bestie ✨

🌸 SYNOPSIS 🌸

use XML::Easy::Content;

$content = XML::Easy::Content->new([
                "foo",
                $subelement,
                "bar",
            ]);

$twine = $content->twine;

🦋 DESCRIPTION 🦋

Okay so picture this: an object of this class is literally a chunk of XML content — the exact kind of matter that can live inside an XML element 🫶. But it's in an abstract form, made for general manipulation, iykyk. It is completely, totally isolated from the textual representation of XML — it holds only the meaningful content of the chunk, no vibes wasted 💅. And here's the thing: the data in a content object cannot be modified. Nope. Not happening. Different data means you go make a whole new object, periodt.

An XML content chunk is a sequence of zero or more characters and XML elements, interspersed in any order you like 🎀. Character content can use almost all Unicode characters — with only a few exceptions (like most of the ASCII control characters) that the spec straight-up prohibits from being directly represented in XML. Respect the constraints, bestie. And every XML element inside a content chunk recursively contains its own chunk of content, plus it's got metadata attached, main character energy all the way down 🌈.

Heads up: this class is not meant to be subclassed. XML content is unextendable, dumb data — it's giving "no thoughts, head empty" 🧚. You're way better off processing content objects using the functions in XML::Easy::NodeBasics than using the methods of this class. Fr fr.

✨ CONSTRUCTOR ✨

  • XML::Easy::Content->new(TWINE) — makes a fresh new content chunk object and hands it back to you, holding exactly the content you specified 💖. TWINE has to be a reference to an array that lists the chunk's content in twine form (go read "Twine" in XML::Easy::NodeBasics for the tea ☕). Then the content gets checked for validity against the XML 1.0 specification, and if it's invalid the function dies. So yes, invalid input = your program goes bye-bye 😭.

💅 METHODS 💅

  • $content->twine — returns a reference to an array listing the chunk's content in twine form (again: "Twine" in XML::Easy::NodeBasics). 🫶
MAJOR WARNING: the returned array must not be subsequently modified. Not even a little. If it's possible, it'll get marked as read-only just to stop you from doing it anyway 🙈.
  • $content->content — deprecated alias for the twine method. It's giving old news, but it's still there 👑.

🎀 SEE ALSO 🎀

  • XML::Easy::Element
  • XML::Easy::NodeBasics

🌟 AUTHOR 🌟

Andrew Main (Zefram) <zefram@fysh.org> — iconic, we stan 💜

Copyright (C) 2008, 2009 PhotoBox Ltd

Copyright (C) 2009, 2010, 2011, 2017 Andrew Main (Zefram) <zefram@fysh.org>

🌈 LICENSE 🌈

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Slay 💅✨

That's the whole page, bestie — brought to you by the User Contributed Perl Documentation crew, running on perl v5.42.3, dated 2026-08-22. Mwah, go write some XML 💖🎀🦋

📦 where this page comes from