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

FreeBSD Manual Pages

  
 
  

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

NAME
     curl_mime_data - set a mime part's body data from memory

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_mime_data(curl_mimepart *part, const char *data,
			     size_t datasize);

DESCRIPTION
     curl_mime_data(3) sets a mime part's body content from memory data.

     part  is  the  mime  part to assign contents to, created with curl_mime_ad-
     dpart(3).

     data points to the data that gets copied by this function. The storage  may
     safely be reused after the call.

     datasize  is  the	number	of  bytes  data  points  to.  It  can  be set to
     CURL_ZERO_TERMINATED  to  indicate  data  is  a  null-terminated  character
     string.

     Setting  a  part's  contents multiple times is valid: only the value set by
     the last call is retained. It is possible to unassign  part's  contents  by
     setting data to NULL.

     Setting   large   data  is  memory  consuming:  one  might  consider  using
     curl_mime_data_cb(3) in such a case.

PROTOCOLS
     This functionality affects http, imap and smtp

EXAMPLE
     int main(void)
     {
       curl_mime *mime;
       curl_mimepart *part;

       CURL *curl = curl_easy_init();
       if(curl) {
	 /* create a mime handle */
	 mime = curl_mime_init(curl);

	 /* add a part */
	 part = curl_mime_addpart(mime);

	 /* add data to the part */
	 curl_mime_data(part, "raw contents to send", CURL_ZERO_TERMINATED);
       }
     }

AVAILABILITY
     Added in curl 7.56.0

RETURN VALUE
     This function returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3). If CURLOPT_ERRORBUFFER(3)  was	set  with  curl_easy_se-
     topt(3)  there  can  be  an  error  message stored in the error buffer when
     non-zero is returned.

SEE ALSO
     curl_mime_addpart(3),	 curl_mime_data_cb(3),	      curl_mime_name(3),
     curl_mime_type(3)

libcurl 			   2026-06-11		       curl_mime_data(3)

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

home | help