---
name: "curl_easy_option_by_id"
section: "3"
platform: "macos"
package: "curl"
version: "166.0.0.0.1"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/curl_easy_option_by_id"
---

# curl\_easy\_option\_by\_id(3)

find an easy setopt option by id

## 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

Given a *CURLoption* **id**, this function returns a pointer to the *curl\_easyoption* struct, holding information about the *[curl\_easy\_setopt(3)](/curl_easy_setopt/3.md)* option using that id. The option id is the CURLOPT\_ prefix 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.

## 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

This function was added in libcurl 7.73.0

## RETURN VALUE

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

## SEE ALSO

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