This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

curl_formget(3)                                libcurl Manual                                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_formget_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)