moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-08-13 17:03:50 -04:00
Code Issues Releases Wiki Activity

clarified and extended with an example

Browse Source
This commit is contained in:
Daniel Stenberg 2001-04-23 11:55:25 +00:00
parent 0ce49cb7ed
commit 8ea5b5bbd0
1 changed files with 29 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
docs/curl_formparse.3
View File

@ -2,26 +2,31 @@
.\" nroff -man [file] .\" nroff -man [file]
.\" Written by daniel@haxx.se .\" Written by daniel@haxx.se
.\" .\"
.TH curl_formparse 3 "5 March 2001" "libcurl 7.0" "libcurl Manual" .TH curl_formparse 3 "23 April 2001" "libcurl 7.7.2" "libcurl Manual"
.SH NAME .SH NAME
curl_formparse - add a section to a multipart/formdata HTTP POST curl_formparse - add a section to a multipart/formdata HTTP POST
.SH SYNOPSIS .SH SYNOPSIS
.B #include <curl/curl.h> .B #include <curl/curl.h>
.sp .sp
.BI "CURLcode curl_formparse(char *" string, "struct HttpPost **" firstitem, .BI "CURLcode curl_formparse(char * " string, " struct HttpPost ** " firstitem,
.BI "struct HttpPost ** "lastitem ");" .BI "struct HttpPost ** " lastitem ");"
.ad .ad
.SH DESCRIPTION .SH DESCRIPTION
curl_formparse() is used to append sections when building a multipart/formdata curl_formparse() is used to append sections when building a multipart/formdata
HTTP POST. Append one section at a time until you've added all the sections HTTP POST (sometimes refered to as rfc1867-style posts). Append one section at
you want included and then you pass the a time until you've added all the sections you want included and then you pass
.I firstitem the \fI firstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
pointer as parameter to CURLOPT_HTTPPOST. \fIlastitem\fP is set after each call and on repeated invokes it should be
.I lastitem left as set to allow repeated invokes to find the end of the list in a faster
is set after each call and on repeated invokes it should be left as set to way. \fIstring\fP must be a zero terminated string following the following
allow repeated invokes to find the end of the list in a faster way. syntax.
.I string
must be a zero terminated string following the following syntax. The pointers \fIfirstitem\fP and \fIlastitem\fP point to, should both be
pointers to NULL in the first call to this function. All list-data will be
allocated by the function itself. You must call \fIcurl_formfree\fP after the
form has been done to free the resources again.
See example below.
.SH "FORM PARSE STRINGS" .SH "FORM PARSE STRINGS"
The The
.I string .I string
@ -55,6 +60,18 @@ content-type for all of them in the same way as with a single file.
.PP .PP
.SH RETURN VALUE .SH RETURN VALUE
Returns non-zero if an error occurs. Returns non-zero if an error occurs.
.SH EXAMPLE
HttpPost* post = NULL;
HttpPost* last = NULL;
/* Add an image section */
curl_formparse("picture=@my-face.jpg", &post, &last);
/* Add a normal text section */
curl_formparse("name=FooBar", &post, &last);
/* Set the form info */
curl_easy_setopt(curl, CURLOPT_HTTPPOST, &post);
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_easy_setopt "(3) " .BR curl_easy_setopt "(3) "
.SH BUGS .SH BUGS