Get a header

Search…
Get a header
CURLHcode curl_easy_header(CURL *easy,
                           const char *name,
                           size_t index,
                           unsigned int origin,
                           int request,
                           struct curl_header **hout);
This function returns information about a field with a specific name, and you ask the function to search for it in one or more origins.
The index argument is when you want to ask for the nth occurrence of a header; when there are more than one available. Setting index to 0 will of course return the first instance - in many cases that is the only one.
The request argument tells libcurl from which request you want headers from.
An application needs to pass in a pointer to a struct curl_header * in the last argument, as there will be a pointer returned there when an error is not returned. See Header struct for details on the out result of a successful call.
If the given name does not match any received header in the given origin, the function returns CURLHE_MISSING or if no headers at all have been received yet it will return CURLHE_NOHEADERS.
Header struct
Iterate over headers
Last modified 1mo ago
Export as PDF
Copy link
Edit on GitHub