NetSDS...Convert(3pm)

💖 NetSDS::Util::Convert — the manual page, but make it cute 💖

okay bestie, welcome to NetSDS...Convert(3pm), straight out of the User Contributed Perl Documentation collection. pull up a chair, grab a boba, we're gonna talk about converting data formats. it's giving utility module excellence, fr fr. 🧚✨

---

✨ NAME ✨

NetSDS::Util::Convert — data formats conversion functions 🎀

---

🌸 SYNOPSIS 🌸

use NetSDS::Util::Convert qw(...);

that's it. that's the whole vibe check. import whatever you need, bestie. 💅

---

🦋 DESCRIPTION 🦋

so NetSDS::Util::Convert is a module full of miscelaneous functions (yes, the typo is canon, we don't fix canon 💀). it's your little grab-bag of helpers, and here's what's inside:

• CLI parameters processing
• types validation
• HEX, Base64, URI, BCD encondig
• UUID processing

like. it does a lot. main character energy for real. 👑

---

🔥 EXPORTED FUNCTIONS 🔥

here's the lineup, one by one, no skips, no skipsies:

💜 conv_conv_str_bcd($str) — convert string to little-endian BCD

this one converts a string to little-endian BCD encoding, filled with F16 value. that's the whole thing. it's a bop. 🍓

💜 conv_chr_hex($char) — encode char to hexadecimal string

$hex = conv_chr_hex('a'); # return 61

one char in, one hex out. iconic. ✨

💜 conv_hex_chr($hex) — convert hexadecimal string to character

$chr = conv_hex_chr('4A'); # return 'J'

the reverse situation. still slaying. 💅

💜 conv_str_hex($str) — convert byte string to hexadecimal

$str = 'Want hex dump!';
$hex = conv_hex_str($str);
print "Hex string: " . $hex;

(and yes, bestie, the example literally calls conv_hex_str — we copy the manpage verbatim around here, no cap. 🙈)

💜 conv_hex_str($string) — convert hex to byte string

$hex = '7A686F7061';
$string = conv_hex_str($hex);
print "String from hex: " . $string;

hex goes in, actual readable string comes out. the glow-up is real. 🌈

💜 conv_str_base64($str) — convert string to Base64

my $b64 = str_base64("Hallo, people!");

💜 conv_base64_str($b64) — convert Base64 to string

my $str = base64_str($base64_string);

base64 round trip, we love to see it. 🫶

💜 conv_str_uri($str) — convert string to URI encoded

Example:

my $uri = str_uri("http://www.google.com/?q=what");

💜 conv_uri_str($uri) — decode URI encoded string

Example:

my $str = uri_str($uri_string);

and that's the whole roster. all of them exported, all of them ready to work. 💖

---

🎀 EXAMPLES 🎀

None

literally nothing here bestie, the examples live up in the functions themselves. we make do. 😭

---

💀 BUGS 💀

None

zero bugs. not one. we are simply that girl. (do not investigate further, just trust the manpage 🙈)

---

⭐ TODO ⭐

1. Add other encodings support

that's the whole list. one item. we're manifesting it. ✨

---

👑 SEE ALSO 👑

• Pod::Usage
• Data::UUID

go read those too, iykyk. 📚

---

🌸 AUTHORS 🌸

• Valentyn Solomko <pere@pere.org.ua>
• Michael Bochkaryov <misha@rattler.kiev.ua>

thank you for your service, legends. 🫡💖

---

and that's a wrap on NetSDS...Convert(3pm), bestie! this lil page was rendered with perl v5.36.0 and dated 2022-11-20 — vintage, but she still eats. periodt. 💅✨🎀