manpagez: man pages & more
man CURLOPT_COPYPOSTFIELDS(3)
Home | html | info | man
CURLOPT_COPYPOSTFIELDS(3)  curl_easy_setopt options  CURLOPT_COPYPOSTFIELDS(3)




NAME

       CURLOPT_COPYPOSTFIELDS - have libcurl copy data to POST


SYNOPSIS

       #include <curl/curl.h>

       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_COPYPOSTFIELDS, char
       *data);


DESCRIPTION

       Pass a char * as parameter, which should be the full data to post in  a
       HTTP  POST  operation.  It behaves as the CURLOPT_POSTFIELDS(3) option,
       but the original data is instead copied by the  library,  allowing  the
       application to overwrite the original data after setting this option.

       Because  data  are copied, care must be taken when using this option in
       conjunction   with   CURLOPT_POSTFIELDSIZE(3)   or   
       CURLOPT_POSTFIELDSIZE_LARGE(3):  If the  size has not been set prior to 
       CURLOPT_COPYPOSTFIELDS(3),  the data is assumed to be a zero terminated 
       string; else the stored size  informs the  library about the byte count 
       to copy. In any case, the size must not  be  changed  after  
       CURLOPT_COPYPOSTFIELDS(3), unless another   CURLOPT_POSTFIELDS(3)  or  
       CURLOPT_COPYPOSTFIELDS(3) option is issued.


DEFAULT

       NULL


PROTO_

EXAMPLE

       CURL *curl = curl_easy_init();
       if(curl) {
         char local_buffer[1024]="data to send";
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

         /* size of the data to copy from the buffer and send in the request */
         curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, 12L);

         /* send data from the local stack */
         curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, local_buffer);

         curl_easy_perform(curl);
       }


AVAILABILITY

       Added in 7.17.1


RETURN VALUE

       Returns CURLE_OK if the option is  supported,  CURLE_UNKNOWN_OPTION  if
       not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space.


SEE ALSO

       CURLOPT_POSTFIELDS(3), CURLOPT_POSTFIELDSIZE(3),



libcurl 7.37.0                    19 Jun 2014        CURLOPT_COPYPOSTFIELDS(3)

curl 7.40.0 - Generated Fri Jan 9 16:37:26 CST 2015
© manpagez.com 2000-2018
Individual documents may contain additional copyright information.