gnurl_formfree(3)

💖 NAME 💖

okay bestie, welcome to the gnurl_formfree(3) page from the libgnurl Manual — this one is literally about curl_formfree: the function that frees a previously build multipart/formdata HTTP POST chain. (Yes, “build” is what the page says; don’t come for me. 💅)

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

void curl_formfree(struct curl_httppost *form);

🦋 DESCRIPTION 🦋

okay so first things first: this function is deprecated. Do not use it! See curl_mime_init(3) instead, bestie. 🫶

curl_formfree() is used to clean up data previously built/appended with curl_formadd(3). This must be called when the data has been used, which typically means after curl_easy_perform(3) has been called.

The pointer to free is the same pointer you passed to the CURLOPT_HTTPPOST(3) option, which is the firstitem pointer from the curl_formadd(3) invoke(s).

form is the pointer as returned from a previous call to curl_formadd(3) and may be NULL.

Passing in a NULL pointer in form will make this function return immediately with no action.

🌸 AVAILABILITY 🌸

Deprecated in 7.56.0.

🎀 RETURN VALUE 🎀

None

🌈 SEE ALSO 🌈

• curl_formadd(3)
• curl_mime_init(3)
• curl_mime_free(3)

and that’s the whole page, bestie! cute sign-off moment: this is from libcurl 7.7.1, dated 6 April 2001, and it’s the gnurl_formfree(3) page. mwah 💋✨