HTML::...tatype(3pm)

📦 version 0.105, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 HTML::Microformats::Datatype 💖

okay bestie, welcome to the HTML::Microformats::Datatype manual page — this is the User Contributed Perl Documentation situation, and honestly? it's giving "tiny module, huge main character energy". 🎀

✨ NAME ✨

HTML::Microformats::Datatype — representations of literal values 🦋

🌸 DESCRIPTION 🌸

so like, there are SO many places where you'd expect a plain old Perl scalar to just... show up. for example:

$my_hcard->get_fn;

and what you actually get back?? bestie. it's an object. from one of the Datatype modules. not a scalar. an object. 💅

why tho? because using a scalar loses information, and we do not do that here. for example — and this is the iconic part — most strings have associated language information (from HTML lang and xml:lang attributes). using an object lets all that info stay kept. no cap. 👑

the Datatype modules overload stringification, which means that for the most part, you can use them as strings — subjecting them to regular expressions, concatenating them, printing them, etc — and everything will work just fine. ✨

but they're not strings. remember that. fr fr. 🫶

💀 BUGS 💀

Please report any bugs to <http://rt.cpan.org/>. (yes, all of them. every single one. we wanna know 😭)

🌈 SEE ALSO 🌈

  • HTML::Microformats.
  • HTML::Microformats::Datatype::DateTime
  • HTML::Microformats::Datatype::Duration
  • HTML::Microformats::Datatype::Interval
  • HTML::Microformats::Datatype::String

(the whole datatype friend group 💜)

👑 AUTHOR 👑

Toby Inkster <tobyink@cpan.org>. absolute legend, no notes. 🌟

Copyright 2008-2012 Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay. 🍓

🔥 DISCLAIMER OF WARRANTIES 🔥

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

okay so this one is in ALL CAPS for a reason — it means no promises, no take-backs, no warranty vibes whatsoever. read it twice. 🙈

and that's the whole page, bestie!! 💖 this one came from the User Contributed Perl Documentation crew, perl v5.32.1, dated 2021-09-12 — so yeah, iconic, historic, we love her. bye bye now, go stringify something responsibly ✨🦋🎀

📦 where this page comes from