URLCODING(3)

🎀 URLCODING 🎀

okay so bestie, pull up a chair 💖 this one lives in the LOCAL manual section, and it's a Libbash library for encoding and decoding URL's. yes, that kind of URL. the fun kind. let's get into it 🦋

---

✨ NAME ✨

urlcoding — a Libbash library for encoding and decoding URL's.

---

🌸 SYNOPSIS 🌸

urlEncodeString [-l] ⟨STRING⟩
urlEncodeFile [-l] ⟨FILE⟩
urlEncodeStream [-l]
urlDecodeString ⟨STRING⟩
urlDecodeFile ⟨FILENAME⟩
urlDecodeStream

---

💅 DESCRIPTION 💅

urlcoding is a whole collection of functions that convert ASCII-text into standard URL's, and do the reverse too — URL's back to ASCII-text. it's giving translator, it's giving bilingual icon 🌈

the AWK code doing all the heavy lifting is based on code by Heiner Steven <heiner.steven@odn.de> — credit where credit is due, we stan 🫶

here's the function list, no gatekeeping:

• urlEncodeString — creates a URL from an ASCII string
• urlEncodeFile — converts a file into URL-valid text
• urlEncodeStream — converts standard input into URL-valid text
• urlDecodeString — converts a URL-encoded text back to a plain-text form
• urlDecodeFile — converts URL-encoded text in a file back to plain text
• urlDecodeStream — converts URL-encoded standard input to text

detailed interface description follows, keep reading, it's worth it ✨

the [-l] option for the encoding functions? yeah, use that one when line-feed characters ('\n') are to be encoded as well. lowkey important 🎀

all functions print the results of their conversions to standard output. every single one. no exceptions, periodt 💅

and the exit status of all functions is that of the command awk, with 0 for success. so if awk is happy, everybody's happy 😌

---

👑 FUNCTIONS DESCRIPTIONS 👑

🍓 urlEncodeString [-l] ⟨STRING⟩

converts STRING — a string of ASCII characters — to URL. slay ✨

🧚 urlEncodeFile [-l] ⟨FILE⟩

Coverts FILE of URL-encoded text to plain text. (that's what it says, bestie — I'm just the messenger 💀)

🦋 urlEncodeStream [-l]

converts text from standard input to URL-text. stream it, queen 👑

💜 urlDecodeString ⟨STRING⟩

converts URL-encoded string STRING back to text. the reverse heist 🔥

🌈 urlDecodeFile ⟨FILENAME⟩

converts the URL-encoded text in FILE to plain text.

⭐ urlDecodeStream

converts the URL-encoded text from standard input to plain-text. last one, you made it 🎉

---

💖 AUTHORS 💖

Alon Keren <alon.keren@gmail.com> — main character energy, honestly 👑

---

🌟 SEE ALSO 🌟

ldbash(1), libbash(1)

---

this page is Linux, UNDATED, and it's URLCODING(3). that's the whole vibe check, bestie — now go encode something cute 💅✨🎀