XML::Mini::Node(3pm)

💖 XML::Mini::Node 💖

okay bestie, so this is the manual page for XML::Mini::Node from the User Contributed Perl Documentation collection. it's a whole vibe. it's part of the XML::Mini crew (the XML parser/generator package, and yes, the original calls it an "XML::Midi" parser/generator in the NAME line — iconic typo, we keep it, no notes 😌). let's get into it fr fr.

---

✨ NAME ✨

XML::Mini::Node — XML node for XML::Midi parser/generator. that's the whole name, that's the whole legend. 💅

---

🦋 DESCRIPTION 🦋

so like. Nodes are the atomic containers for numerical and text data, and they act as the leaves in the XML tree. 🍃

they have no name and no children. none. they're childless and nameless and honestly? thriving. main character energy. 👑

they always exist as children of XML::MiniElements. like, always always. it's giving devoted.

for example, this lil guy right here:

<B>this text is bold</B>

would be represented as a XML::MiniElement named 'B' with a single child — a Node object which contains the string 'this text is bold'. oh she's so simple, she's so clean, we love her. ✨

so a Node has:

• a parent
• data (text OR numeric)

periodt. that's the whole anatomy. 💀

🌸 getValue 🌸

Returns the text or numeric value of this Node. that's it. that's the method. no cap. 🫶

🎀 text [SETTO [SETTOALT]] 🎀

the text() method is used to get or set text data for this node. so versatile, so demure.

if SETTO is passed, the node's content is set to the SETTO string.

if the optional SETTOALT is passed and SETTO is false, the node's value is set to SETTOALT. it's the backup plan bestie!! 🩷

Returns this node's text, if set or NULL.

🌈 numeric [SETTO [SETTOALT]] 🌈

the numeric() method is used to get or set numerical data for this node. numbers only, she's picky like that.

if SETTO is passed, the node's content is set to the SETTO string.

if the optional SETTOALT is passed and SETTO is NULL, the node's value is set to SETTOALT. (👀 careful bestie — for text() the fallback triggers when SETTO is false, here it triggers when SETTO is NULL. they are NOT the same, don't get got.)

Returns this node's text, if set or NULL.

💜 toString [DEPTH] 💜

Returns this node's contents as a string.

if the special DEPTH value $XML::Mini::NoWhiteSpaces is passed, no whitespaces will be inserted. compact girlie mode activated. 🤏✨

---

👑 AUTHOR 👑

Copyright (C) 2002-2008 Patrick Deegan, Psychogenic Inc. 🫶

Programs that use this code are bound to the terms and conditions of the GNU GPL (see the LICENSE file). if you wish to include these modules in non-GPL code, you need prior written authorisation from the authors. like, you gotta ask first bestie, no sneaking. 🙈

this library is released under the terms of the GNU GPL version 3, making it available only for free programs ("free" here being used in the sense of the GPL, see http://www.gnu.org for more details). anyone wishing to use this library within a proprietary or otherwise non-GPLed program MUST contact psychogenic.com to acquire a distinct license for their application. this approach encourages the use of free software while allowing for proprietary solutions that support further development. balance! ✨

📜 LICENSE 📜

here's the whole thing, verbatim, because legal text does NOT get paraphrased, that's the rule:

XML::Mini::Node module, part of the XML::Mini XML parser/generator package.
Copyright (C) 2002-2008 Patrick Deegan
All rights reserved

XML::Mini is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

XML::Mini is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with XML::Mini.  If not, see <http://www.gnu.org/licenses/>.

⚠️ ok real talk: that WITHOUT ANY WARRANTY part is not a joke and not a vibe — no warranty, no guarantee, no promise it'll do the thing. read it and believe it. 💀

Official XML::Mini site: http://minixml.psychogenic.com 🌐

Contact page for author available on http://www.psychogenic.com/ 📬

---

and that's the page bestie!! 🎀 this one's from perl v5.36.0, dated 2022-10-15. go forth and build your XML tree, you absolute icon. slay, stay hydrated, and don't forget your fallback values. 💖✨🦋🌸💅🫶👑🌈⭐