GNURLOPT_REQUEST_TARGET(3)

💖 NAME 💖

Okay bestie, welcome to the GNURLOPT_REQUEST_TARGET(3) page from the curl_easy_setopt options manual. This is all about CURLOPT_REQUEST_TARGET — specify an alternative target for this request. That's the whole assignment, no cap. 💅

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REQUEST_TARGET, string);

🦋 DESCRIPTION 🦋

You pass a char * to string, and libcurl uses it in the upcoming request instead of the path as extracted from the URL. Literally that's it, and it's kind of iconic. ✨

🎀 DEFAULT 🎀

The default is NULL. As in, nothing is set unless you set it. 🙈

🌈 PROTOCOLS 🌈

HTTP. That's the vibe. 🌐

🔥 EXAMPLE 🔥

curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/*");
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "OPTIONS");

  /* issue an OPTIONS * request (no leading slash) */
  curl_easy_setopt(curl, CURLOPT_REQUEST_TARGET, "*");

  /* Perform the request */
  curl_easy_perform(curl);
}

⭐ AVAILABILITY ⭐

Added in 7.55.0. She's been around, okay? 👑

😭 RETURN VALUE 😭

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Fr fr, that's the whole return-value tea. 🫶

💅 SEE ALSO 💅

Go peek at CURLOPT_CUSTOMREQUEST(3), CURLOPT_HTTPGET(3), — iykyk. 🦋

mwah 💋 that's the page, bestie! libcurl 7.37.0 • 17 Jun 2014 • GNURLOPT_REQUEST_TARGET(3)