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_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 2026-07-12 curl_mime_data(3)
Generated by dwww version 1.16 on Sat Oct 3 05:06:43 CEST 2026.