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

FreeBSD Manual Pages

  
 
  

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

NAME
       CURLINFO_SIZE_DOWNLOAD -	get the	number of downloaded bytes

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_getinfo(CURL *handle,	CURLINFO_SIZE_DOWNLOAD,	double *dlp);

DESCRIPTION
       Pass  a	pointer	 to a double 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
       and not included	in this	number.

       CURLINFO_SIZE_DOWNLOAD_T(3)  is a newer replacement that	returns	a more
       sensible	variable type.

PROTOCOLS
       This functionality affects all supported	protocols

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

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

	   if(!res) {
	     /*	check the size */
	     double dl;
	     res = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD, &dl);
	     if(!res) {
	       printf("Downloaded %.0f bytes\n", dl);
	     }
	   }
	 }
       }

DEPRECATED
       Deprecated since	7.55.0.

AVAILABILITY
       Added in	curl 7.4.1

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_T(3),  CURLINFO_SIZE_UPLOAD_T(3),	  CURLOPT_MAX-
       FILESIZE(3), curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl				  2025-06-03	     CURLINFO_SIZE_DOWNLOAD(3)

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

home | help