curl\_easy\_option\_by\_id(3) Library Functions Manual curl\_easy\_option\_by\_id(3)

# [NAME](#NAME)

curl\_easy\_option\_by\_id - find an easy setopt option by id

# [SYNOPSIS](#SYNOPSIS)

```
#include <curl/curl.h>
const struct curl_easyoption *curl_easy_option_by_id(CURLoption id);
```

# [DESCRIPTION](#DESCRIPTION)

Given a *CURLoption* **id**, this function returns a pointer to the *curl\_easyoption* struct, holding information about the [*curl\_easy\_setopt(3)*](/man/os/curl/curl_easy_setopt.3) option using that id. The option id is the *CURLOPT\_* prefixed ones provided in the standard curl/curl.h header file. This function returns the non-alias version of the cases where there is an alias function as well.

If libcurl has no option with the given id, this function returns NULL.

# [PROTOCOLS](#PROTOCOLS)

This functionality affects all supported protocols

# [EXAMPLE](#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);


  }
}
```

# [AVAILABILITY](#AVAILABILITY)

Added in curl 7.73.0

# [RETURN VALUE](#RETURN_VALUE)

A pointer to the *curl\_easyoption* struct for the option or NULL.

# [SEE ALSO](#SEE_ALSO)

[**curl\_easy\_option\_by\_name**(3)](/man/os/curl/curl_easy_option_by_name.3), [**curl\_easy\_option\_next**(3)](/man/os/curl/curl_easy_option_next.3), [**curl\_easy\_setopt**(3)](/man/os/curl/curl_easy_setopt.3)

2026-10-31 libcurl

---

Document: curl_easy_option_by_id(3) from curl 8.23.0-r3 (Chainguard OS)
Source: https://github.com/curl/curl.git