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 con-
       tents 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_setopt(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				  2025-06-03		     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+14.3.quarterly>

home | help