e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
56 lines
1.1 KiB
Markdown
56 lines
1.1 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: curl_easy_option_by_name
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- curl_easy_option_by_id (3)
|
|
- curl_easy_option_next (3)
|
|
- curl_easy_setopt (3)
|
|
Protocol:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
curl_easy_option_by_name - find an easy setopt option by name
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#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.
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
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);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
This function was added in libcurl 7.73.0
|
|
|
|
# RETURN VALUE
|
|
|
|
A pointer to the *curl_easyoption* struct for the option or NULL.
|