curl_url_cleanup(3)

💅 curl_url_cleanup(3) — free the URL handle 💖

okay so bestie, welcome to the Library Functions Manual corner where curl_url_cleanup(3) is the main character. it's giving free the URL handle, and honestly? obsessed. 🎀

---

🌸 NAME 🌸

curl_url_cleanup — free the URL handle 🫶

✨ SYNOPSIS ✨

#include <curl/curl.h>

void curl_url_cleanup(CURLU *handle);

that's the whole signature, bestie. the argument is CURLU *handle. that's it. 💅

🧚 DESCRIPTION 🧚

okay so what does it do? it frees all the resources associated with the given CURLU handle. all of them. the handle gets its cleanup moment, periodt. 💖

Passing in a NULL pointer in handle makes this function return immediately with no action. like, it literally just vibes back out — no cleanup, no drama. 🙈

and listen closely: any use of the handle after this function has been called and has returned is illegal. not "oops bestie" illegal — illegal. After cleanup returns, do not touch that handle. 💀

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols. all of them, bestie. no cap. 💅

🧚 EXAMPLE 🧚

here's the little demo, exactly as it should be:

int main(void)
{
  CURLU *url = curl_url();
  curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  curl_url_cleanup(url);
}

see? it makes a CURLU with curl_url(), sets the URL part with curl_url_set(url, CURLUPART_URL, "https://example.com", 0), then calls curl_url_cleanup(url). clean, cute, iconic. 🎀

🦋 AVAILABILITY 🦋

Added in curl 7.62.0. that's the origin story, bestie. 🫶

💜 RETURN VALUE 💜

none. literally none. that's the entire return value section. no cap. 💅

🍓 SEE ALSO 🍓

go give these other pages some love, iykyk:

• CURLOPT_CURLU(3)
• curl_url(3)
• curl_url_dup(3)
• curl_url_get(3)
• curl_url_set(3)

---

mwah 💖 — this page is from libcurl, dated 2026-10-12. curl_url_cleanup(3) out! 🫶