Debbugs::UTF8(3pm)

💖 NAME 💖

Debbugs::UTF8 — the routine collection for converting charsets into UTF8. bestie, it's giving "glow up for your encoding" ✨

---

🎀 SYNOPSIS 🎀

use Debbugs::UTF8;

that's it. that's the whole vibe check. 💅

---

🦋 DESCRIPTION 🦋

okay so listen. this module is literally just a bundle of routines that convert from all the various different charsets into UTF8. no cap. that's its whole personality and honestly? iconic. 👑

---

🌸 FUNCTIONS 🌸

💜 UTF-8

these functions are exported with the :utf8 tag 🫶

💅 encode_utf8_structure

%newdata = encode_utf8_structure(%newdata);

takes a complex data structure and encodes any strings that have is_utf8 set into their constituent octets. it goes deep, bestie — full structural commitment. 💖

🍓 encode_utf8_safely

$octets = encode_utf8_safely($string);

given a $string, it hands you back the octet equivalent of $string if $string is in perl's internal encoding — otherwise it just gives you back $string. no drama, no fuss. ✨

not me forgetting about REFs 😭 — this one silently returns REFs without encoding them. if you want to deeply encode REFs, go look at encode_utf8_structure instead, okay?

🧚 decode_utf8_safely

$string = decode_utf8_safely($octets);

given $octets in UTF8, it returns the perl-internal equivalent of $octets if $octets does not have is_utf8 set — otherwise it just returns $octets right back at you. 🦋

same energy as above: it silently returns REFs without encoding them. 🙈

🌈 convert_to_utf8

$utf8 = convert_to_utf8("text","charset");

that's the signature. that's the whole thing. slay. ⭐

---

👑 sign-off 👑

this whole thing is perl v5.40.1, dated 2026-04-27, and it lives under the User Contributed Perl Documentation umbrella. mwah 💋 go convert some charsets, bestie — fr fr. 🎀✨