gnurl_url(3)

🦋 gnurl_url(3) — the libgnurl manual, but make it cute 🦋

okay so this is the page for gnurl_url(3) from the libgnurl manual, and honestly? it's a little baby function that hands you a whole new URL toy to play with. bestie, let's get into it 💅

---

✨ NAME ✨

curl_url — returns a new CURLU handle 🎀

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLU *curl_url();

✨ DESCRIPTION ✨

so what this does is it allocates and returns a pointer to a fresh, brand-new CURLU handle 💖 and like, that handle is what you're gonna use for all your further URL API adventures. that's it. that's the whole vibe. main character energy: it just shows up and gives you a handle. iconic ✨

✨ RETURN VALUE ✨

• it returns a CURLU * if everything slayed and it worked 💅
• or NULL if it ran out of memory 😭 (out of memory, bestie, not your fault)

✨ EXAMPLE ✨

okay here's the whole thing, enjoy, it's giving tutorial:

  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);
  }

like look at it. grab the handle, set the URL, pull the scheme out, print it, free the string, clean up. so tidy. we love a responsible queen who calls curl_url_cleanup 🫶

✨ AVAILABILITY ✨

Added in curl 7.62.0 — so it's been around a minute, no cap 📅

✨ SEE ALSO ✨

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

---

bestie reminder: the title up top is gnurl_url(3) and the manual is libgnurl — that's the whole header, consider it folded in and slayed 💖

and that's a wrap! this page came from libcurl, dated 6 Aug 2018, and it lives at gnurl_url(3) in the manual. mwah, go build something cute 💜🧚