Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_SIZE_DOWNLOAD_T(3) Library Functions Manual CURLINFO_SIZE_DOWNLOAD_T(3)

NAME
     CURLINFO_SIZE_DOWNLOAD_T - number of downloaded bytes

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_DOWNLOAD_T,
				curl_off_t *dlp);

DESCRIPTION
     Pass  a  pointer  to a curl_off_t to receive the total amount of bytes that
     were downloaded. The amount is only for the latest transfer and gets  reset
     again  for  each new transfer. This counts actual payload data, what's also
     commonly called body. All meta  and  header  data	is  excluded  from  this
     amount.

PROTOCOLS
     This functionality affects all supported protocols

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

	 /* Perform the request */
	 result = curl_easy_perform(curl);

	 if(result == CURLE_OK) {
	   /* check the size */
	   curl_off_t dl;
	   result = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD_T, &dl);
	   if(result == CURLE_OK) {
	     printf("Downloaded %" CURL_FORMAT_CURL_OFF_T " bytes\n", dl);
	   }
	 }
       }
     }

AVAILABILITY
     Added in curl 7.55.0

RETURN VALUE
     curl_easy_setopt(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
     CURLINFO_SIZE_DOWNLOAD(3),    CURLINFO_SIZE_UPLOAD_T(3),	CURLOPT_MAXFILE-
     SIZE(3), curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl 			   2026-06-11	     CURLINFO_SIZE_DOWNLOAD_T(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_SIZE_DOWNLOAD_T&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help