curl_easy_option_by_id(3)

curl_easy_option_by_id3

Find an easy setopt option by id

Usage

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

Overview

Given a CURLoption id, this function returns a pointer to the curl_easyoption struct, holding information about the 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

This functionality affects all supported protocols

Examples

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);
  }
}

Return value

A pointer to the curl_easyoption struct for the option or NULL.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

Availability

Added in curl 7.73.0

From curl 8.23.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.