GNURLINFO_PRIVATE(3)

okay bestie, welcome to the <pink>GNURLINFO_PRIVATE(3)</pink> page — yep, the <cyan>curl_easy_getinfo</cyan> options crew. today we're getting the private pointer, and honestly it's giving tiny-but-mighty icon energy. ✨

💖 NAME 💖

CURLINFO_PRIVATE — get the private pointer. literally just that, bestie. 🫶

✨ SYNOPSIS ✨

here's the exact signature, no cap:

#include <gnurl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIVATE, char
**private);

🦋 DESCRIPTION 🦋

you pass in a pointer to a char pointer so it can receive the pointer to the private data that's associated with the curl handle — the one you set with CURLOPT_PRIVATE(3). okay and important: for internal reasons, the value comes back as a char pointer, even though it's effectively a 'void *'. that's the vibe, that's the fact. 💅

🌈 PROTOCOLS 🌈

All — every single one, periodt. ⭐

🧚 EXAMPLE 🧚

here's the whole lil demo, copy it, love it:

CURL *curl = curl_easy_init();
if(curl) {
  void *pointer = 0x2345454;
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");

  /* set the private pointer */
  curl_easy_setopt(curl, CURLOPT_PRIVATE, pointer);
  ret = curl_easy_perform(curl);

  /* extract the private pointer again */
  ret = curl_easy_getinfo(curl, CURLINFO_PRIVATE, &pointer);

  curl_easy_cleanup(curl);
}

👑 AVAILABILITY 👑

this cutie was added in 7.10.3 ✨

🎀 RETURN VALUE 🎀

if the option is supported, you get CURLE_OK; if not, you get CURLE_UNKNOWN_OPTION. no in-between, bestie. 💖

🍓 SEE ALSO 🍓

• curl_easy_getinfo(3)
• curl_easy_setopt(3)
• CURLOPT_PRIVATE(3)

xoxo, bestie — this page came from libcurl 7.44.0, dated 1 Sep 2015. 💅🫶