curl_easy_option_by_name(3)

curl_easy_option_by_name3

Find an easy setopt option by name

Usage

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

Overview

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

This functionality affects all supported protocols

Examples

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

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.