GNURLOPT_P...SIZE_LARGE(3)

🎀 GNURLOPT_POSTFIELDSIZE_LARGE — bestie's guide to the size of POST data pointed to 🎀

Okay so this is a page from the gnurl manual, section 3 (GNURLOPT_P...SIZE_LARGE(3) — yes the title got squished by the terminal, she's fine) 💅. Sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

CURLOPT_POSTFIELDSIZE_LARGE — literally the size of the POST data you're pointing at 🫶

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE_LARGE,
                          curl_off_t size);

That's the whole vibe. You pass a curl_off_t called size and she slays 🦋

---

✨ DESCRIPTION ✨

Okay so picture this: you wanna post data to the server, but you do not want libcurl running strlen() to measure how big your data is. Then this option is the one 👑. You must use it in that case — it's not optional, it's the whole point.

When you use this option, you can post fully binary data, which otherwise is likely to fail 😭 (binary + strlen() = disaster, no cap).

And if you set this size to -1, the library goes back to using strlen() to get the size. Yep, back to the old ways 🙈

---

✨ DEFAULT ✨

-1

---

✨ PROTOCOLS ✨

HTTP(S) 💖

---

✨ EXAMPLE ✨

Here's the whole thing, copy it exactly bestie:

CURL *curl = curl_easy_init();
if(curl) {
  const char *data = large_chunk;
  curl_off_t length_of_data; /* set somehow */

  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

  /* size of the POST data */
  curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE_LARGE, length_of_data);

  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);

  curl_easy_perform(curl);
}

Notice the /* set somehow */ comment — that's not me being shady, that's literally what the page says. You gotta figure out that length yourself, bestie 🧚

---

✨ AVAILABILITY ✨

She ships along with HTTP 🌈

---

✨ RETURN VALUE ✨

• Returns CURLE_OK if HTTP is supported 💚
• Returns CURLE_UNKNOWN_OPTION if it's not 💀

That's it, that's the whole check.

---

✨ SEE ALSO ✨

• CURLOPT_POSTFIELDS(3)
• CURLOPT_COPYPOSTFIELDS(3)
• CURLOPT_POSTFIELDSIZE(3),

(Yes, that last comma is living there rent free, and I'm not evicting her 🎀)

---

tiny warning bb 🫶 — if you set a size that doesn't match your actual data, that's on you, not on me. This page only tells you what's written here, fr fr.

---

Okay that's the whole page, mwah 💋 — this cutie is from libcurl 7.37.0, dated 17 Jun 2014, so show her some respect, she's been iconic since before some of y'all were born 🌸💜