Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

CURLINFO_EFFECTIVE_URL (3)

Name

CURLINFO_EFFECTIVE_URL - get the last used URL

Synopsis

#include <curl/curl.h>

CURLcode  curl_easy_getinfo(CURL  *handle, CURLINFO_EFFECTIVE_URL, char
**urlp);

Description

CURLINFO_EFFECTIVE_URL(3)  curl_easy_getinfo options CURLINFO_EFFECTIVE_URL(3)



NAME
       CURLINFO_EFFECTIVE_URL - get the last used URL

SYNOPSIS
       #include <curl/curl.h>

       CURLcode  curl_easy_getinfo(CURL  *handle, CURLINFO_EFFECTIVE_URL, char
       **urlp);

DESCRIPTION
       Pass in a pointer to a char pointer and get  the  last  used  effective
       URL.

       In  cases  when  you've  asked libcurl to follow redirects, it may very
       well not be the same value you set with CURLOPT_URL(3).

       The urlp pointer will be NULL or pointing to private  memory  you  MUST
       NOT free - it gets freed when you call curl_easy_cleanup(3) on the cor-
       responding CURL handle.

PROTOCOLS
       HTTP(S)

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         CURLcode res;
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
         curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
         res = curl_easy_perform(curl);
         if(res == CURLE_OK) {
           char *url = NULL;
           curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_URL, &url);
           if(url)
             printf("Redirect to: %s\n", url);
         }
         curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in 7.4

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       curl_easy_getinfo(3), curl_easy_setopt(3),



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from    https://github.com/curl/curl/ar-
       chive/curl-7_64_0.zip

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.44.0                    28 Aug 2015        CURLINFO_EFFECTIVE_URL(3)