MHonArc...MapUTF8(3)

💖 MHonArc::UTF8::MapUTF8 💖

ok so bestie, real talk: this is the MHonArc...MapUTF8(3) page — a User Contributed Perl Documentation situation, and honestly it's giving very "small but crucial supporting character" energy. She's not the main character of the MHonArc universe, but nothing works without her. 🎀

---

🌸 NAME 🌸

MHonArc::UTF8::MapUTF8 — the UTF-8 Unicode::MapUTF8-based routines for MHonArc. That's it, that's the whole name, and she eats every time. ✨

---

🦋 SYNOPSIS 🦋

use MHonArc::UTF8::MapUTF8;

one line. one vibe. iconic. 💅

---

🧚 DESCRIPTION 🧚

okay so MHonArc::UTF8::MapUTF8 hands you UTF-8 related routines for use in MHonArc, and it does it by using Perl's v5.6 (or later, no cap) Unicode::MapUTF8 module — which you can grab via CPAN, because of course. 💜

now here's the tea ☕: this module is generally not accessed directly, since it gets used by MHonArc::UTF8 when that module is figuring out which encoding routines it can actually use, based on your perl installation. so she's like the friend who does all the work behind the scenes and never asks for credit. lowkey hero behavior. 🫶

---

🔥 FUNCTIONS 🔥

⭐ to_utf8($data, $from_charset, $to_charset)

Converts $data that's encoded in $from_charset into UTF-8. annnnd $to_charset? bestie, she is ignored, because it's assumed to be "utf-8" already. we love an option that's just there for company. 💀

⭐ str2sgml($data, $charset)

Everything you pass in gets converted to utf-8, with HTML specials converted into entity references. so all the spicy < > & characters get handled properly. slay. 🌈

⭐ clip($text, $clip_len, $is_html, $has_tags)

Clips $text down to $clip_len number of characters. short and sweet, exactly like the function itself. ✂️

---

🌟 SEE ALSO 🌟

• MHonArc::UTF8 — go look, she's the one who actually calls this module. iykyk 💫

---

🎀 VERSION 🎀

"$Id: MapUTF8.pm,v 1.2 2003/03/05 22:17:15 ehood Exp $"

vintage. retro. a 2003 moment. 🙈

---

👑 AUTHOR 👑

Earl Hood, earl@earlhood.com — the legend himself. 💖

⚠️ okay important part, don't scroll past: MHonArc comes with ABSOLUTELY NO WARRANTY, and MHonArc may be copied only under the terms of the GNU General Public License, which may be found in the MHonArc distribution. no cap, that's the actual legal vibe, read it and respect it. 💅

---

and that's the whole page, bestie — so glad you came to my TED talk 🦋

sign-off szn: this little beauty ships with perl v5.42.3 and was dated 2020-11-16. go forth and convert your charsets. mwah 💋🌸