GNURLOPT_TIMECONDITION(3)

okay so bestie, welcome to the GNURLOPT_TIMECONDITION(3) page — yes, it comes from the curl_easy_setopt options manual, and we are absolutely treating it like main character energy. 💅 This is the little setopt that picks the condition for a time request, and it is lowkey iconic for conditional requests. ✨

🎀 NAME 🎀

CURLOPT_TIMECONDITION — select condition for a time request. That's the whole assignment, and it ate. 💖

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMECONDITION, long
       cond);

So you're calling curl_easy_setopt with a CURL *handle, the CURLOPT_TIMECONDITION option, and a long cond. Slay. 🫶

💅 DESCRIPTION 💅

You pass a long as the parameter, bestie. This defines how the CURLOPT_TIMEVALUE(3) time value is treated — like, it's the vibe check for that timestamp. You can set this parameter to CURL_TIMECOND_IFMODSINCE or CURL_TIMECOND_IFUNMODSINCE. Both valid, both in the group chat. 🌸

caveat time: the last modification time of a file is not always known, and in such instances this feature will have no effect even if the given time condition would not have been met. No cap, it just does nothing in that case. 😭

If you're nosy after a transfer, you can use curl_easy_getinfo(3) with the CURLINFO_CONDITION_UNMET option to learn if a zero-byte successful "transfer" was due to this condition not matching. That's your little detective moment. 🔥

👑 DEFAULT 👑

CURL_TIMECOND_NONE (0)

That's it. Zero condition, zero drama. 🎀

🌈 PROTOCOLS 🌈

HTTP, FTP, RTSP, and FILE. Bestie, that's the lineup. ✨

🦋 AVAILABILITY 🦋

Always. Like, always always. 💜

⭐ RETURN VALUE ⭐

Returns CURLE_OK. We love a clean success era. 🫶

🍓 SEE ALSO 🍓

• CURLOPT_TIMEVALUE(3),

(Yes, with the comma. Copy it exactly, bestie.) 💅

💖 EXAMPLE 💖

Okay, example time — this code is doing the absolute most in the best way:

       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

         /* January 1, 2020 is 1577833200 */
         curl_easy_setopt(curl, CURLOPT_TIMEVALUE, 1577833200L);

         /* If-Modified-Since the above time stamp */
         curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);

         /* Perform the request */
         curl_easy_perform(curl);
       }

It sets the URL, sets CURLOPT_TIMEVALUE to 1577833200L (the comment says that's January 1, 2020, and we respect the comment), uses CURL_TIMECOND_IFMODSINCE, then performs the request. Periodt. 💅

---

xoxo, your Unix bestie 🫶 — this page is libcurl 7.37.0 from 17 Jun 2014, and the footer is giving GNURLOPT_TIMECONDITION(3) energy. Bye bestie, go set some time conditions. 💖✨