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

# [NAME](#NAME)

curl\_easy\_option\_by\_name - find an easy setopt option by name

# [SYNOPSIS](#SYNOPSIS)

```
#include <curl/curl.h>
const struct curl_easyoption *curl_easy_option_by_name(const char *name);
```

# [DESCRIPTION](#DESCRIPTION)

Given a **name**, 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 name. The name should be specified without the *CURLOPT\_* prefix and the name comparison is made case insensitive.

If libcurl has no option with the given name, 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_name("URL");


  if(opt) {


    printf("This option wants CURLoption %x\n", (unsigned int)opt->id);


  }
}
```

# [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\_id**(3)](/man/os/curl/curl_easy_option_by_id.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-19 libcurl

---

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