CURLOPT_HEADER(3) curl_easy_setopt options CURLOPT_HEADER(3)NAMECURLOPT_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 ALSOCURLOPT_HEADERFUNCTION(3), CURLOPT_HTTPHEADER(3),
libcurl 7.37.0 16 Jun 2014 CURLOPT_HEADER(3)