gnurl_unescape(3)

🦋 gnurl_unescape(3) — the libgnurl Manual glow-up 🦋

Okay so welcome to the gnurl_unescape(3) page from the libgnurl Manual, bestie. We are decoding the URL drama, and yes, the manual name is right there near the top like a little name tag. 💅

---

✨ NAME ✨

curl_unescape - URL decodes the given string

Like, that is literally the whole name section. Short, sweet, and already telling you what's up.

---

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

char *curl_unescape( const char *url, int length );

That's the exact signature — no cap, no edits, no "fixing" the spacing. 🫶

---

💅 DESCRIPTION 💅

⚠️ Obsolete function. Use curl_easy_unescape(3) instead! This one is literally wearing a "vintage" sign, okay?

This function will convert the given URL encoded input string to a "plain string" and return that as a new allocated string. All input characters that are URL encoded (%XX where XX is a two-digit hexadecimal number) will be converted to their plain text versions. Slay. ✨

If the 'length' argument is set to 0, curl_unescape() will use strlen() on the input 'url' string to find out the size. Cute.

You must curl_free(3) the returned string when you're done with it. Do not ghost the cleanup — free it, bestie. 🧚

---

👑 AVAILABILITY 👑

Since 7.15.4, curl_easy_unescape(3) should be used. This function will be removed in a future release. So yeah, it's giving limited-time era. 🕰️

---

🎀 RETURN VALUE 🎀

A pointer to a null-terminated string or NULL if it failed. That's it. Either the decoded string or the big sad NULL. 😭

---

🌈 SEE ALSO 🌈

The original SEE ALSO list is empty here — no references, just a heading doing main character energy. The page already name-drops curl_easy_unescape(3) as the replacement up in DESCRIPTION and AVAILABILITY, iykyk.

---

💖 Cute sign-off: this page is from libcurl 7.7, dated 22 March 2001, and it's still serving vintage Unix realness. 🫶