GNURLOPT_HTTPGET(3)

🎀 NAME 🎀

okay so this is GNURLOPT_HTTPGET(3) — the manual-name badge is right there, bestie — and the actual star is CURLOPT_HTTPGET: it means ask for an HTTP GET request. That's the whole name, no cap. 💖

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPGET, long useget);

💅 DESCRIPTION 💅

You pass a long, bestie. If useget is 1, this forces the HTTP request to get back to using GET. It's usable if a POST, HEAD, PUT, etc has been used previously using the same curl handle. Iconic method-reset behavior, fr fr. 🦋

When setting CURLOPT_HTTPGET(3) to 1, it will automatically set CURLOPT_NOBODY(3) to 0 and CURLOPT_UPLOAD(3) to 0. Like, it quietly fixes those little flags for you. 🫶

Setting this option to zero has no effect. Applications need to explicitly select which HTTP request method to use — they cannot deselect a method. To reset a handle to default method, consider curl_easy_reset(3). So zero is not a magic undo button, okay? 🙈

🚨 vibe check: 0 here has no effect. If you're trying to get back to the default method, the original page points you at curl_easy_reset(3).

🍓 DEFAULT 🍓

0

🌈 PROTOCOLS 🌈

HTTP(S)

🔥 EXAMPLE 🔥

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

  /* use a GET to fetch this */
  curl_easy_setopt(curl, CURLOPT_HTTPGET, 1L);

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

👑 AVAILABILITY 👑

Along with HTTP.

⭐ RETURN VALUE ⭐

Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.

🦋 SEE ALSO 🦋

• CURLOPT_NOBODY(3)
• CURLOPT_UPLOAD(3)
• CURLOPT_POST(3)
• curl_easy_reset(3)

---

💌 sign-off: this page comes from libcurl 7.37.0, dated 17 Jun 2014, and its manual-name badge is GNURLOPT_HTTPGET(3) — love u, bye bestie 🫶💅