.\" generated by cd2nroff 0.1 from curl_formfree.md .TH curl_formfree 3 "2024-11-07" libcurl .SH NAME curl_formfree \- free a previously build multipart form post chain .SH SYNOPSIS .nf #include void curl_formfree(struct curl_httppost *form); .fi .SH DESCRIPTION This function is deprecated. Do not use. See \fIcurl_mime_init(3)\fP instead. curl_formfree() is used to clean up data previously built/appended with \fIcurl_formadd(3)\fP. This must be called when the data has been used, which typically means after \fIcurl_easy_perform(3)\fP has been called. The pointer to free is the same pointer you passed to the \fICURLOPT_HTTPPOST(3)\fP option, which is the \fIfirstitem\fP pointer from the \fIcurl_formadd(3)\fP invoke(s). \fBform\fP is the pointer as returned from a previous call to \fIcurl_formadd(3)\fP and may be NULL. Passing in a NULL pointer in \fIform\fP makes this function return immediately with no action. .SH PROTOCOLS This functionality affects http only .SH EXAMPLE .nf int main(void) { CURL *curl = curl_easy_init(); if(curl) { struct curl_httppost *formpost; struct curl_httppost *lastptr; /* Fill in a file upload field */ curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, "file", CURLFORM_FILE, "nice-image.jpg", CURLFORM_END); curl_easy_setopt(curl, CURLOPT_HTTPPOST, formpost); curl_easy_perform(curl); /* then cleanup the formpost chain */ curl_formfree(formpost); } } .fi .SH DEPRECATED Deprecated in 7.56.0. .SH AVAILABILITY Added in curl 7.1 .SH RETURN VALUE None .SH SEE ALSO .BR curl_formadd (3), .BR curl_mime_free (3), .BR curl_mime_init (3)