CURLINFO_NUM_CONNECTS(3)

CURLINFO_NUM_CONNECTS(3curl_easy_getinfo optionCURLINFO_NUM_CONNECTS(3)

NAME

     CURLINFO_NUM_CONNECTS - get number of created connections

SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_getinfo(CURL           *handle,
     CURLINFO_NUM_CONNECTS, long *nump);

DESCRIPTION

     Pass a pointer to a long to receive how many new connections
     libcurl had to create to achieve the previous transfer (only
     the  successful  connects  are  counted).    Combined   with
     CURLINFO_REDIRECT_COUNT(3)  you  are  able  to know how many
     times libcurl successfully reused existing connection(s)  or
     not.   See  the connection options of curl_easy_setopt(3) to
     see how libcurl tries to make persistent connections to save
     time.

PROTOCOLS

     All

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) {
         long connects;
         res = curl_easy_getinfo(curl, CURLINFO_NUM_CONNECTS, &connects);
         if(res)
           printf("It needed %d connects\n", connects);
       }
       curl_easy_cleanup(curl);
     }

AVAILABILITY

     Added in 7.12.3

RETURN VALUE

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

SEE ALSO

     curl_easy_getinfo(3), curl_easy_setopt(3),

libcurl 7.58.0      Last change: May 06, 2017                   1