FreeBSD Manual Pages
CURLINFO_CONDITION_UNMET(3) Library Functions Manual CURLINFO_CONDITION_UNMET(3) NAME CURLINFO_CONDITION_UNMET - unmet time conditional or 304 HTTP response SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONDITION_UNMET, long *unmet); DESCRIPTION Pass a pointer to a long to receive the number 1 if the condition provided in the previous request did not match (see CURLOPT_TIMECONDITION(3)). Alas, if this returns a 1 you know that the reason you did not get data in return is because it did not fulfill the condition. The long this argument points to gets a zero stored if the condition instead was met. This can also re- turn 1 if the server responded with a 304 HTTP status code, for example af- ter sending a custom "If-Match-*" header. PROTOCOLS This functionality affects http only EXAMPLE int main(void) { CURL *curl = curl_easy_init(); if(curl) { CURLcode result; curl_easy_setopt(curl, CURLOPT_URL, "https://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 */ result = curl_easy_perform(curl); if(result == CURLE_OK) { /* check the time condition */ long unmet; result = curl_easy_getinfo(curl, CURLINFO_CONDITION_UNMET, &unmet); if(result == CURLE_OK) { printf("The time condition was %sfulfilled\n", unmet ? "NOT" : ""); } } } } AVAILABILITY Added in curl 7.19.4 RETURN VALUE curl_easy_getinfo(3) returns a CURLcode indicating success or error. CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3). SEE ALSO CURLOPT_TIMECONDITION(3), CURLOPT_TIMEVALUE(3), curl_easy_getinfo(3), curl_easy_setopt(3) libcurl 2026-06-11 CURLINFO_CONDITION_UNMET(3)
NAME | SYNOPSIS | DESCRIPTION | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_CONDITION_UNMET&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>