.\" generated by cd2nroff 0.1 from curl_easy_option_by_name.md
.TH curl_easy_option_by_name 3 "2025-10-19" libcurl
.SH NAME
curl_easy_option_by_name \- find an easy setopt option by name
.SH SYNOPSIS
.nf
#include <curl/curl.h>

const struct curl_easyoption *curl_easy_option_by_name(const char *name);
.fi
.SH DESCRIPTION
Given a \fBname\fP, this function returns a pointer to the \fIcurl_easyoption\fP
struct, holding information about the \fIcurl_easy_setopt(3)\fP option using that
name. The name should be specified without the \fICURLOPT_\fP prefix and the name
comparison is made case insensitive.

If libcurl has no option with the given name, this function returns NULL.
.SH PROTOCOLS
This functionality affects all supported protocols
.SH EXAMPLE
.nf
int main(void)
{
  const struct curl_easyoption *opt = curl_easy_option_by_name("URL");
  if(opt) {
    printf("This option wants CURLoption %x\\n", (int)opt->id);
  }
}
.fi
.SH AVAILABILITY
Added in curl 7.73.0
.SH RETURN VALUE
A pointer to the \fIcurl_easyoption\fP struct for the option or NULL.
.SH SEE ALSO
.BR curl_easy_option_by_id (3),
.BR curl_easy_option_next (3),
.BR curl_easy_setopt (3)