moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2025-02-28 09:21:50 -05:00
Code Issues Releases Wiki Activity

curl_formget.3: CURLFORM_STREAM has its drawbacks

Browse Source 
Due to a design flaw, the CURLFORM_STREAM option doesn't really work
with curl_formget until after curl_easy_perform (or similar).
This commit is contained in:
Daniel Stenberg 2011-06-13 22:03:33 +02:00
parent 832e827518
commit 84e13f2e07
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/libcurl/curl_formget.3
View File

@ -23,24 +23,27 @@
.SH NAME .SH NAME
curl_formget - serialize a previously built multipart/formdata HTTP POST chain curl_formget - serialize a previously built multipart/formdata HTTP POST chain
.SH SYNOPSIS .SH SYNOPSIS
.nf
.B #include <curl/curl.h> .B #include <curl/curl.h>
.sp
.BI "void curl_formget(struct curl_httppost *" form, " void *" arg, void curl_formget(struct curl_httppost * form, void *userp,
.BI " curl_formget_callback " append ");" curl_formget_callback append );
.ad
.SH DESCRIPTION .SH DESCRIPTION
curl_formget() is used to serialize data previously built/appended with curl_formget() is used to serialize data previously built/appended with
\fIcurl_formadd(3)\fP. Accepts a void pointer as second argument which will be \fIcurl_formadd(3)\fP. Accepts a void pointer as second argument named
passed to the curl_formget_callback function. \fIuserp\fP which will be passed as the first argument to the
curl_formget_callback function.
.BI "typedef size_t (*curl_formget_callback)(void *" arg, " const char *" buf, .BI "typedef size_t (*curl_formget_callback)(void *" userp, " const char *" buf,
.BI " size_t " len ");" .BI " size_t " len ");"
.nf
The curl_formget_callback will be executed for each part of the HTTP POST The curl_formget_callback will be executed for each part of the HTTP POST
chain. The void *arg pointer will be the one passed as second argument to chain. The character buffer passed to the callback must not be freed. The
curl_formget(). The character buffer passed to it must not be freed. The
callback should return the buffer length passed to it on success. callback should return the buffer length passed to it on success.
If the \fBCURLFORM_STREAM\fP option is used in the formpost, it will prevent
\fIcurl_formget(3)\fP from working until you've performed the actual HTTP
request as only then will libcurl get the actual read callback to use!
.SH RETURN VALUE .SH RETURN VALUE
0 means everything was ok, non-zero means an error occurred 0 means everything was ok, non-zero means an error occurred
.SH EXAMPLE .SH EXAMPLE
@ -52,6 +55,7 @@ callback should return the buffer length passed to it on success.
(*(size_t *) arg) += len; (*(size_t *) arg) += len;
return len; return len;
} }
size_t print_httppost(struct curl_httppost *post) size_t print_httppost(struct curl_httppost *post)
{ {
size_t total_size = 0; size_t total_size = 0;