CURLINFO_SCHEME(3)

CURLINFO_SCHEME3

Get the url scheme (sometimes called protocol) used in the connection

Usage

#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SCHEME, char **scheme);

Overview

Pass a pointer to a char pointer to receive the pointer to a null-terminated string holding the URL scheme used for the most recent connection done with this CURL handle.

The scheme pointer is NULL or points to private memory. You MUST NOT free - it gets freed when you call curl_easy_cleanup(3) on the corresponding CURL handle.

Protocols

All

Examples

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    res = curl_easy_perform(curl);
    if(res == CURLE_OK) {
      char *scheme = NULL;
      curl_easy_getinfo(curl, CURLINFO_SCHEME, &scheme);
      if(scheme)
        printf("scheme: %s\n", scheme); /* scheme: HTTP */
    }
    curl_easy_cleanup(curl);
  }
}

Return value

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.

Releases

60 releases since macOS 10.12.6; the text changed 11 times.

  1. 10.12.6–10.14.6
  2. 10.15–11.5
  3. 12.0.1–12.2
  4. 12.3–12.5
  5. 13.0
  6. 13.1
  7. 13.2
  8. 13.3
  9. 13.4
  10. 13.5–14.1
  11. 14.2–14.4
  12. 14.5–26.5

Availability

Added in 7.52.0

From curl 166.0.0.0.1 in macOS 26.5. Parsed by carta from the page's man source.