| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455 |
- .\" generated by cd2nroff 0.1 from curl_mime_addpart.md
- .TH curl_mime_addpart 3 "2025-01-17" libcurl
- .SH NAME
- curl_mime_addpart \- append a new empty part to a mime structure
- .SH SYNOPSIS
- .nf
- #include <curl/curl.h>
- curl_mimepart *curl_mime_addpart(curl_mime *mime);
- .fi
- .SH DESCRIPTION
- \fIcurl_mime_addpart(3)\fP creates and appends a new empty part to the given
- mime structure and returns a handle to it. The returned part handle can
- subsequently be populated using functions from the mime API.
- \fImime\fP is the handle of the mime structure in which the new part must be
- appended.
- .SH PROTOCOLS
- This functionality affects http, imap and smtp
- .SH EXAMPLE
- .nf
- 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);
- /* continue and set name + data to the part */
- curl_mime_data(part, "This is the field data", CURL_ZERO_TERMINATED);
- curl_mime_name(part, "data");
- }
- }
- .fi
- .SH AVAILABILITY
- Added in curl 7.56.0
- .SH RETURN VALUE
- A mime part structure handle, or NULL upon failure.
- .SH SEE ALSO
- .BR curl_mime_data (3),
- .BR curl_mime_data_cb (3),
- .BR curl_mime_encoder (3),
- .BR curl_mime_filedata (3),
- .BR curl_mime_filename (3),
- .BR curl_mime_headers (3),
- .BR curl_mime_init (3),
- .BR curl_mime_name (3),
- .BR curl_mime_subparts (3),
- .BR curl_mime_type (3)
|
