curl_formget(3)

NAME

       curl_formget  -  serialize  a  previously build multipart/formdata HTTP
       POST chain

SYNOPSIS

       #include <curl/curl.h>

       void curl_formget(struct curl_httppost *form,  void  *arg,    curl_for-
       mget_callback append);

DESCRIPTION

       curl_formget() is used to serialize data previously built/appended with
       curl_formadd(3). Accepts a void pointer as second argument  which  will
       be passed to the curl_formget_callback function.

       typedef  size_t  (*curl_formget_callback)(void  *arg, const char *buf,
       size_t len);

       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
       curl_formget(). The character buffer passed to it must not be freed. The
       callback should return the buffer length passed to it on success.

RETURN VALUE

       0 means everything was ok, non-zero means an error occurred

EXAMPLE

        size_t print_httppost_callback(void *arg, const char *buf, size_t len)
        {
          fwrite(buf, len, 1, stdout);
          (*(size_t *) arg) += len;
          return len;
        }
        size_t print_httppost(struct curl_httppost *post)
        {
          size_t total_size = 0;
          if(curl_formget(post, &total_size, print_httppost_callback)) {
            return (size_t) -1;
          }
          return total_size;
        }

AVAILABILITY

       This function was added in libcurl 7.15.5

SEE ALSO

       curl_formadd(3)

libcurl 7.15.5                   20 June 2006                  curl_formget(3)