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




NAME

       CURLOPT_READDATA - custom pointer passed to the read callback


SYNOPSIS

       #include <curl/curl.h>

       CURLcode    curl_easy_setopt(CURL   *handle,   CURLOPT_READDATA,   void
       *pointer);


DESCRIPTION

       Data pointer to pass to the file read function. If  you  use  the  CUR-
       LOPT_READFUNCTION(3) option, this is the pointer you'll get as input in
       the 4th argument to the callback.

       If you don't specify a read callback but instead rely  on  the  default
       internal read function, this data must be a valid readable FILE * (cast
       to 'void *').

       If you're using libcurl as a win32 DLL, you MUST  use  a  CURLOPT_READ-
       FUNCTION(3) if you set this option.


DEFAULT

       By default, this is a FILE * to stdin.


PROTOCOLS

       This is used for all protocols when sending data.


EXAMPLE

       CURL *curl = curl_easy_init();
       struct MyData this;
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

         /* pass pointer that gets passed in to the
            CURLOPT_READFUNCTION callback */
         curl_easy_setopt(curl, CURLOPT_READDATA, &this);

         curl_easy_perform(curl);
       }


AVAILABILITY

       This  option  was once known by the older name CURLOPT_INFILE, the name
       CURLOPT_READDATA(3) was introduced in 7.9.7.


RETURN VALUE

       This will return CURLE_OK.


SEE ALSO

       CURLOPT_READFUNCTION(3), CURLOPT_WRITEDATA(3),



libcurl 7.37.0                    16 Jun 2014              CURLOPT_READDATA(3)

curl 7.49.0 - Generated Sat May 21 14:53:19 CDT 2016
© manpagez.com 2000-2018
Individual documents may contain additional copyright information.