| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 |
- .\" generated by cd2nroff 0.1 from curl_mime_name.md
- .TH curl_mime_name 3 "2025-01-17" libcurl
- .SH NAME
- curl_mime_name \- set a mime part\(aqs name
- .SH SYNOPSIS
- .nf
- #include <curl/curl.h>
- CURLcode curl_mime_name(curl_mimepart *part, const char *name);
- .fi
- .SH DESCRIPTION
- \fIcurl_mime_name(3)\fP sets a mime part\(aqs name. This is the way HTTP form
- fields are named.
- \fIpart\fP is the part\(aqs handle to assign a name to.
- \fIname\fP points to the null\-terminated name string.
- The name string is copied into the part, thus the associated storage may
- safely be released or reused after call. Setting a part\(aqs name multiple times
- is valid: only the value set by the last call is retained. It is possible to
- reset the name of a part by setting \fIname\fP to NULL.
- .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);
- /* give the part a name */
- curl_mime_name(part, "shoe_size");
- }
- }
- .fi
- .SH AVAILABILITY
- Added in curl 7.56.0
- .SH RETURN VALUE
- CURLE_OK or a CURL error code upon failure.
- .SH SEE ALSO
- .BR curl_mime_addpart (3),
- .BR curl_mime_data (3),
- .BR curl_mime_type (3)
|
