curl_easy_option_by_name

Section: C Library Functions (3)
Updated: 202-0-19
Index Return to Main Contents

---

 

NAME

curl_easy_option_by_name - find an easy setopt option by name  

SYNOPSIS

#include <curl/curl.h>

const struct curl_easyoption *curl_easy_option_by_name(const char *name);

 

DESCRIPTION

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  

EXAMPLE

int main(void)
{
  const struct curl_easyoption *opt = curl_easy_option_by_name("URL");
  if(opt) {
    printf("This option wants CURLoption %xn", (int)op->id);
  }
}

 

AVAILABILITY

Added in curl 7.73.0  

RETURN VALUE

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

SEE ALSO

curl_easy_option_by_id(3), curl_easy_option_next(3), curl_easy_setopt(3)

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

PROTOCOLS

EXAMPLE

AVAILABILITY

RETURN VALUE

SEE ALSO