Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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_POSTFIELD-
       SIZE_LARGE(3):  If the size has not been	set prior to CURLOPT_COPYPOST-
       FIELDS(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), un-
       less  another CURLOPT_POSTFIELDS(3) or CURLOPT_COPYPOSTFIELDS(3)	option
       is issued.

DEFAULT
       NULL

PROTOCOLS
       HTTP(S)

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	5.5.5		       February	03, 2016     CURLOPT_COPYPOSTFIELDS(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_COPYPOSTFIELDS&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help