curl_url(3)

✨ curl_url(3) ✨

okay so bestie, welcome to the Library Functions Manual — this is the page for curl_url, and honestly it's the main character of the whole URL API squad 🎀

🌸 NAME 🌸

curl_url — create a URL handle 💅

🦋 SYNOPSIS 🦋

#include <curl/curl.h>

CURLU *curl_url();

💖 DESCRIPTION 💖

So this function allocates a URL object and hands you back a CURLU handle for it — and that handle is literally the input to every other URL API function. She's the entry point, the door, the vibe check at the front of the club 🫶

It's a handle to a URL object that holds — or can hold — URL components for a single URL. When the object first gets created, there's obviously no components stored in there yet (baby's empty, she's fresh ✨). You set them in the object afterwards with the curl_url_set(3) function.

ok real talk though: the object must be destroyed with a call to curl_url_cleanup(3) when you don't need it anymore. like, don't just abandon her, that's not the move 😭

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — no cap, all of them 👑

🍓 EXAMPLE 🍓

int main(void)
{
  CURLUcode rc;
  CURLU *url = curl_url();
  rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  if(!rc) {
    char *scheme;
    rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0);
    if(!rc) {
      printf("the scheme is %s\n", scheme);
      curl_free(scheme);
    }
    curl_url_cleanup(url);
  }
}

⭐ AVAILABILITY ⭐

Added in curl 7.62.0 — she's been around a minute 💜

🔥 RETURN VALUE 🔥

Returns a CURLU * if it goes well, or NULL if you're out of memory 💀

🧚 SEE ALSO 🧚

• CURLOPT_CURLU(3)
• curl_url_cleanup(3)
• curl_url_dup(3)
• curl_url_get(3)
• curl_url_set(3)
• curl_url_strerror(3)

---

laters bestie 🫶 this page is from libcurl, dated 2026-10-12, and it's the curl_url(3) page — go build something iconic with it ✨👑