CURLINFO_TOTAL_TIME.md (1514B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLINFO_TOTAL_TIME 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLINFO_TOTAL_TIME_T (3) 9 - CURLOPT_TIMEOUT (3) 10 - curl_easy_getinfo (3) 11 - curl_easy_setopt (3) 12 Protocol: 13 - All 14 Added-in: 7.4.1 15 --- 16 17 # NAME 18 19 CURLINFO_TOTAL_TIME - get total time of previous transfer 20 21 # SYNOPSIS 22 23 ~~~c 24 #include <curl/curl.h> 25 26 CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TOTAL_TIME, double *timep); 27 ~~~ 28 29 # DESCRIPTION 30 31 Pass a pointer to a double to receive the total time in seconds for the 32 previous transfer, including name resolving, TCP connect etc. The double 33 represents the time in seconds, including fractions. 34 35 When a redirect is followed, the time from each request is added together. 36 37 See also the TIMES overview in the curl_easy_getinfo(3) man page. 38 39 # %PROTOCOLS% 40 41 # EXAMPLE 42 43 ~~~c 44 int main(void) 45 { 46 CURL *curl = curl_easy_init(); 47 if(curl) { 48 CURLcode res; 49 double total; 50 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/"); 51 res = curl_easy_perform(curl); 52 if(CURLE_OK == res) { 53 res = curl_easy_getinfo(curl, CURLINFO_TOTAL_TIME, &total); 54 if(CURLE_OK == res) { 55 printf("Time: %.1f", total); 56 } 57 } 58 /* always cleanup */ 59 curl_easy_cleanup(curl); 60 } 61 } 62 ~~~ 63 64 # %AVAILABILITY% 65 66 # RETURN VALUE 67 68 curl_easy_getinfo(3) returns a CURLcode indicating success or error. 69 70 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 71 libcurl-errors(3).