KHTTP_URLDECODE(3)

💅 KHTTP_URLDECODE(3) — like, the whole manual, bestie

okay so first things first: this is page KHTTP_URLDECODE(3) from the Library Functions Manual, and literally the whole vibe is URL decoding for kcgi. two functions, one job, let's go ✨

🎀 LIBRARY 🎀

the library is “libkcgi” — yes girl, that one. 💖

🦋 SYNOPSIS 🦋

like, here's the exact spell you gotta cast:

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

enum kcgi_err
khttp_urldecode(const char *src, char **dst);

enum kcgi_err
khttp_urldecode_inplace(char *src);

🌸 DESCRIPTION 🌸

so the assignment is: decode the percent-encoded string src. that's it. that's the whole thing. 🫶

• in khttp_urldecode(), the result gets placed in dst.
• in khttp_urldecode_inplace(), the input string src is overwritten with the result, and the result will be the same length or shorter. no cap. ✨

these accept uppercase and lowercase percent encoding — for example, "%A0" or "%a0", respectively. both slay equally, iykyk. 💅

⚠️ okay important: the deprecated form of these functions, kutil_urldecode() and kutil_urldecode_inplace(), should no longer be used. like, they're giving expired milk. please don't. 💀

🔥 RETURN VALUES 🔥

both functions return an error code, and here's the whole menu:

• KCGI_OK — success! not an error. we love her. 👑
• KCGI_ENOMEM — memory failure. and note: this is only for khttp_urldecode(). 😭
• KCGI_FORM — malformed input, or NULL src or dst arguments. input said "no <3". 🙈

⚠️ and here's the caveat, bestie, listen up: if khttp_urldecode() returns an error, it always sets dst to NULL. but khttp_urldecode_inplace(), however, may leave a partially-decoded string in src. so like... vibe check your src after, fr fr. 💀

---

🌈 AUTHORS 🌈

written by Kristaps Dzonsons <kristaps@bsd.lv> — an absolute icon, periodt. 🎀

---

and that's the whole thing, babe 🦋💜 — this cutie came from Debian, version $Mdocdate$, and we're closing out at KHTTP_URLDECODE(3). mwah 💋✨🍓