manpagez: man pages & more
man CURLINFO_EFFECTIVE_METHOD(3)
Home | html | info | man
CURLINFO_EFFECTIVE_METHOD(3)                          Library Functions Manual


NAME

       CURLINFO_EFFECTIVE_METHOD - get the last used HTTP method


SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_EFFECTIVE_METHOD,
                                  char **methodp);


DESCRIPTION

       Pass in a pointer to a char pointer and get the last used effective
       HTTP method.

       In cases when you have asked libcurl to follow redirects, the method
       may not be the same method the first request would use.

       The methodp 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

       This functionality affects http only


EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           CURLcode res;
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
           curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "data");
           curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
           res = curl_easy_perform(curl);
           if(res == CURLE_OK) {
             char *method = NULL;
             curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_METHOD, &method);
             if(method)
               printf("Redirected to method: %s\n", method);
           }
           curl_easy_cleanup(curl);
         }
       }


AVAILABILITY

       Added in curl 7.72.0


RETURN VALUE

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


SEE ALSO

       CURLOPT_CUSTOMREQUEST(3), CURLOPT_FOLLOWLOCATION(3),
       curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl                           2024-08-05      CURLINFO_EFFECTIVE_METHOD(3)

curl 8.9.1 - Generated Tue Aug 13 16:32:29 CDT 2024
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.