KHTTP_URLENCODE(3)

💖 KHTTP_URLENCODE 💖

okay so bestie, welcome to khttp_urlencode from libkcgi — it's the glow-up function that takes your string and makes it URL-safe. percent-encoding slay, no cap ✨

---

🌸 NAME 🌸

khttp_urlencode — URL encoding for kcgi 🎀

📚 LIBRARY 📚

library “libkcgi” — yeah, the whole thing lives in there, iykyk 🦋

✨ SYNOPSIS ✨

like, include these first or it's giving compilation error 💀

#include <sys/types.h>
#include <stdarg.h>
#include <stdint.h>
#include <kcgi.h>

char *
khttp_urlencode(const char *cp);

💅 DESCRIPTION 💅

okay so the main character here is khttp_urlencode. it percent-encodes a string cp — usually so you can embed it in a URL — and hands you back the allocated result. so iconic of it 🫶

if you pass it a NULL? it still returns an allocated empty string. not me finding that so cute 😭 literally never crashes on you, it's so well-adjusted.

the encoding uses capital-letter hex encoding. capital letters. periodt. 🔥

👑 RETURN VALUES 👑

• returns a newly-allocated string 🎀 that you must free with free(3) — bestie please actually free it, don't leak on me 🙈
• returns NULL if allocation fails 😭 (it's not a vibe but it happens)

⚠️ also, just so you know: the deprecated form of this function, kutil_urlencode(), should no longer be used. it's giving old money, and not in a cute way. use this one instead 💅

🌈 EXAMPLES 🌈

here's the pre- and post-encoding table, bestie — look at what it does to these strings 🔥

foo bar   foo+bar
foo+bar   foo%2Bbar

so foo bar becomes foo+bar (space → +, ate), and foo+bar becomes foo%2Bbar (the plus gets encoded as %2B — capital hex, told you 💖). notice how the + is literally the one being escaped there, no cap. the way the same character means two different things... main character energy tbh ⭐

🧚 AUTHORS 🧚

Written by Kristaps Dzonsons <kristaps@bsd.lv>. king shit 👑 thank you for your service 🫶

---

mwah ok that's the whole page bestie 💜 this came from the Debian build, version $Mdocdate$, and the page itself is KHTTP_URLENCODE(3) — go forth and percent-encode responsibly, ily 🎀🌸✨