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




NAME

       CURLOPT_HEADER - pass headers to the data stream


SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HEADER, long onoff);


DESCRIPTION

       Pass in onoff set to 1 to tell the library to include the header in the
       body output for requests with this handle. This option is relevant  for
       protocols  that actually have headers or other meta-data (like HTTP and
       FTP).

       When asking to get the header info passed to the same callback  as  the
       body,  it  is  not  possible  to accurately separate them again without
       detailed knowledge about the protocol in use.

       It is often better to use CURLOPT_HEADERFUNCTION(3) to get  the  header
       data separately.

       While  named  confusingly similar, CURLOPT_HTTPHEADER(3) is used to set
       custom HTTP headers!


DEFAULT

       0


PROTOCOLS

       Most


EXAMPLE

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

         curl_easy_setopt(curl, CURLOPT_HEADER, 1L);

         curl_easy_perform(curl);
       }


RETURN VALUE

       Returns CURLE_OK.


SEE ALSO

       CURLOPT_HEADERFUNCTION(3), CURLOPT_HTTPHEADER(3),



libcurl 7.37.0                    16 Jun 2014                CURLOPT_HEADER(3)

curl 7.42.0 - Generated Fri Apr 24 06:14:19 CDT 2015
© manpagez.com 2000-2018
Individual documents may contain additional copyright information.