curl_easy_option_by_id(3)

💅 curl_easy_option_by_id(3) — Library Functions Manual 💅

okay so bestie, welcome to the libcurl section of the manual, this one's called curl_easy_option_by_id(3) and it's literally the lookup girlie for setopt options 💖

---

✨ NAME ✨

curl_easy_option_by_id — find an easy setopt option by id 🎀

✨ SYNOPSIS ✨

#include <curl/curl.h>

const struct curl_easyoption *curl_easy_option_by_id(CURLoption id);

✨ DESCRIPTION ✨

so you hand this function a CURLoption id, and it gives you back a pointer to the curl_easyoption struct that's holding all the info about the curl_easy_setopt(3) option with that id. periodt. 🫶

the option id is one of those CURLOPT_-prefixed ones that live in the standard curl/curl.h header file — yk, the classic ones 👑

and here's a lil detail that matters: in the cases where there's an alias function too, this function returns the non-alias version. no cap. 🦋

if libcurl genuinely has no option with the id you gave it, this function just returns NULL. that's it, that's the whole vibe. 💀

✨ PROTOCOLS ✨

this functionality affects all supported protocols — like, every single one, no gatekeeping 🌈

✨ EXAMPLE ✨

int main(void)
{
  const struct curl_easyoption *opt = curl_easy_option_by_id(CURLOPT_URL);
  if(opt) {
    printf("This option wants type %x\n", opt->type);
  }
}

look at her go 😭 so cute, so functional 🍓

✨ AVAILABILITY ✨

added in curl 7.73.0 — so if you're on something older, sorry bestie, upgrade time 🙈

✨ RETURN VALUE ✨

a pointer to the curl_easyoption struct for the option — or NULL if it's not giving 💅

✨ SEE ALSO ✨

• curl_easy_option_by_name(3)
• curl_easy_option_next(3)
• curl_easy_setopt(3)

---

ngl if you got NULL back, double-check that id before you start blaming the library, bestie 💀

---

🌸 okay that's the whole page, mwah 🌸 — brought to you by libcurl, dated 2026-10-12, and yes the girl herself is curl_easy_option_by_id(3) 💜 slay, bye ✨