CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.md (1441B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLINFO_CONTENT_LENGTH_DOWNLOAD_T 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLINFO_CONTENT_LENGTH_UPLOAD_T (3) 9 - curl_easy_getinfo (3) 10 - curl_easy_setopt (3) 11 Protocol: 12 - HTTP 13 Added-in: 7.55.0 14 --- 15 16 # NAME 17 18 CURLINFO_CONTENT_LENGTH_DOWNLOAD_T - get content-length of download 19 20 # SYNOPSIS 21 22 ~~~c 23 #include <curl/curl.h> 24 25 CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T, 26 curl_off_t *content_length); 27 ~~~ 28 29 # DESCRIPTION 30 31 Pass a pointer to a *curl_off_t* to receive the content-length of the 32 download. This is the value read from the Content-Length: field. Stores -1 if 33 the size is not known. 34 35 # %PROTOCOLS% 36 37 # EXAMPLE 38 39 ~~~c 40 int main(void) 41 { 42 CURL *curl = curl_easy_init(); 43 if(curl) { 44 CURLcode res; 45 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 46 47 /* Perform the request */ 48 res = curl_easy_perform(curl); 49 50 if(!res) { 51 /* check the size */ 52 curl_off_t cl; 53 res = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T, &cl); 54 if(!res) { 55 printf("Download size: %" CURL_FORMAT_CURL_OFF_T "\n", cl); 56 } 57 } 58 } 59 } 60 ~~~ 61 62 # %AVAILABILITY% 63 64 # RETURN VALUE 65 66 curl_easy_getinfo(3) returns a CURLcode indicating success or error. 67 68 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 69 libcurl-errors(3).