RDF::T...l::XML(3pm)

📦
version 0.16 · 6 versions
, in debian bookworm, ubuntu noble

💖 NAME 💖

RDF::Trine::Node::Literal::XML — the RDF Node class for XMLLiterals, bestie. It's giving "I hold your XML and I hold it correctly." 👑

✨ METHODS ✨

🎀 new ( $node )

🎀 new ( $string [ , $lang, $datatype ] )

okay so this returns a brand-new XML Literal object, and the way it works is that there are two whole different ways to call it — you can hand it a string, or you can hand it an XML::LibXML node. Pick your fighter. 💅

Case one: you passed a string. Then this method follows the exact same API as the RDF::Trine::Node::Literal constructor, with these little twists:

  • $string must be a well-balanced XML fragment. no cap, it has to balance. 🦋
  • $lang is optional, but if a language code is present it will be used as the value of the xml:lang attribute(s) on the root XML element(s) of the literal. And if the element already has an xml:lang attribute? It gets overwritten, periodt. 🙈 For the node types that don't support adding a language — that's text and CData — a warning will be issued. (sorry bestie, them's the rules 😭)
  • $datatype will be ignored and set to 'http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral'. Like, it's not even up for discussion. 💀

Case two: you passed an XML::LibXML node as $node. Then the Node may be one of these types, or a subclass thereof:

  • XML::LibXML::Document
  • XML::LibXML::DocumentFragment
  • XML::LibXML::Element
  • XML::LibXML::CDATASection
  • XML::LibXML::NodeList
  • XML::LibXML::Text
🚨 WARNING bestie 🚨 — if the string is not a valid XML fragment, and the $node is not one of the types listed above, this method throws a RDF::Trine::Error exception. Not a vibe. Handle it.

🌸 xml_element 🌸

Returns the XML::LibXML node for the XML Literal. That's it, that's the whole method, and honestly? iconic. ✨

👑 AUTHOR 👑

First created by Gregory Todd Williams <gwilliams@cpan.org>, modfied and maintained by Kjetil Kjernsmo <kjetilk@cpan.org>. 🫶

and that's the whole page, bestie!! this one shipped with perl v5.34.0, dated 2022-06-17, from the User Contributed Perl Documentation crew — so go forth and XML Literal responsibly, mwah 💖🧚⭐

📦 where this page comes from