GNURLINFO_NUM_CONNECTS(3)

🌸 NAME 🌸

Hey bestie 💖 this is GNURLINFO_NUM_CONNECTS(3), straight from the curl_easy_getinfo options manual — and it's all about get number of created connections ✨

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

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

---

💅 DESCRIPTION 💅

Okay so you pass in a pointer to a long, and it receives how many brand-new connections libcurl had to create to pull off the previous transfer — and no cap, only the successful connects are counted 💖

Team it up with CURLINFO_REDIRECT_COUNT(3) and you can figure out how many times libcurl successfully reused existing connection(s) or didn't 👑 Check the connection options in curl_easy_setopt(3) to see how libcurl tries to make persistent connections and save time — iconic behavior, honestly ⭐

bestie, the “only successful connects” thing is the whole vibe check here 💅

---

🌈 PROTOCOLS 🌈

All — every protocol, periodt 🌈

---

🎀 EXAMPLE 🎀

Here's the exact example, untouched and serving main-character energy:

       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 — vintage but still iconic 🎀

---

🔥 RETURN VALUE 🔥

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Simple as that, bestie 💜

---

🫶 SEE ALSO 🫶

curl_easy_getinfo(3), curl_easy_setopt(3), — go read those too, iykyk 👑

---

Signed off with libcurl 7.44.0 energy, dated 12 Sep 2015 — mwah 💋