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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_S...DOWNLOAD_T(3) Library Functions Manual CURLINFO_S...DOWNLOAD_T(3)

NAME
       CURLINFO_SIZE_DOWNLOAD_T	- get the 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 ex-
       cluded from this	amount.

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 */
	     curl_off_t	dl;
	     res = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD_T, &dl);
	     if(!res) {
	       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				  2025-06-03	    CURLINFO_S...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+14.3.quarterly>

home | help