GOLF(2gg)

💖 GOLF(2gg) 💖

okay bestie, we're in the Development section of the 2gg manual and today's main character is encode-url. she's a little function, she's a baddie, and she's about to make your strings safe for URLs. let's get into it 🫶

---

✨ NAME ✨

encode-url — it's giving URL-encoding, fr fr 🌈

---

🎯 PURPOSE 🎯

URL-encode a string. that's it, that's the whole vibe. slay 💅

---

🧚 SYNTAX 🧚

encode-url <string> to <encoded string> \
    [ input-length <length> ]

so you hand her a string, you tell her where to put the encoded result, and optionally you can whisper input-length in her ear. periodt ✨

---

🌸 DESCRIPTION 🌸

encode-url takes <string>, URL-encodes it, and drops the glow-up version into <encoded string>. literally the simplest relationship ever, no cap 💜

now about that <length> in the input-length clause — she lets you say exactly how many bytes of <string> should get encoded. if you don't specify it, or if you give her a negative number, she just uses the whole string length. she's flexible like that 🙈

here's the tea on what actually gets encoded: every single byte gets the treatment except alphanumerics and the characters from "-._~" — that's dash, dot, underscore, and tilde. those four are the safe little icons who get to stay exactly as they are 👑

heads up bestie: everything else? encoded. no exceptions, no mercy, that's just how she rolls 💀

---

🎀 EXAMPLES 🎀

so in this example, we have a string called "str" and we URL-encode it, and the result lands in a string variable called "result":

set-string str="  x=y?z&  "
encode-url str to result

and the "result"? she ate and left no crumbs:

"%20%20x%3Dy%3Fz%26%20%20"

see how those spaces became %20 and the =, ?, and & all got their little percent codes? iconic behavior honestly 🦋

---

👀 SEE ALSO 👀

• URL encoding 🌈
• decode-url — the reverse queen, check her out 💖
• encode-url (yes, she's listing herself, main character energy 👑)
• See all documentation 📚

---

okay that's the whole page, you're officially educated on encode-url 💅✨ this was version $VERSION, dated $DATE, and yes this absolute banger lives in the GOLF(2gg) manual. go forth and encode responsibly, bestie 🍓💜