Text::...alents(3pm)

✨ Text::Unicode::Equivalents(3pm) ✨

okay bestie, so this is a page out of the User Contributed Perl Documentation, section 3pm, and it's giving canonical equivalence in the most unhinged way possible. buckle up 🎀

---

💖 NAME 💖

Text::Unicode::Equivalents — synthesize canonically equivalent strings 🦋

---

🌸 SYNOPSIS 🌸

        use Text::Unicode::Equivalents qw( all_strings);

        $aref = all_strings ($string);
        map {print "$_\n"} @{$aref};

like, that's it. that's the whole API. iconic behaviour honestly 👑

---

✨ DESCRIPTION ✨

• all_string($s) — so you hand this baby an arbitrary string, and all_strings() hands you back a reference to an array. no cap. and that array is unsorted (do not come for the order, there is no order, the order is vibes) and it contains all unique strings that are canonically equivalent to the argument you passed in. every. single. one. 💅

---

💀 BUGS 💀

ngl this one hurts. it Uses Unicode::Normalize. and here's the tea 🍓: on some systems (the example given is ActiveState 5.6.1) Unicode::Normalize is only aware of Unicode 3.0. which means any de/compositions introduced since Unicode 3.0 will not be used. so if your favourites are missing, that's why 😭

---

🫶 AUTHOR 🫶

Bob Hallissy — the main character who wrote this 🧚

---

👑 COPYRIGHT 👑

Copyright(C) 2003-2011, SIL International.

This package is published under the terms of the Perl Artistic License.

---

friendly lil reminder bestie: that's Copyright(C) 2003-2011, SIL International. exactly as written, and the license is the Perl Artistic License. don't be weird about it 🙈

---

🌈 the sign-off 💜

this whole thing is from perl v5.36.0, dated 2022-10-22, and it lives in the manual as Text::...alents(3pm) 🎀 (yes the title really is truncated like that in the header and footer, i don't make the rules, i just slay within them ✨)

so yeah. go forth, synthesize your equivalents, and remember: all_strings() returns unique, unsorted, canonically equivalent strings and nothing else. periodt. 💖