table of contents
- trixie 8.14.1-2
- trixie-backports 8.16.0-4~bpo13+1
- testing 8.17.0~rc2-1
- unstable 8.17.0~rc3-1
| CURLINFO_CONTENT_TYPE(3) | Library Functions Manual | CURLINFO_CONTENT_TYPE(3) |
NAME¶
CURLINFO_CONTENT_TYPE - get Content-Type
SYNOPSIS¶
#include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_TYPE, char **ct);
DESCRIPTION¶
Pass a pointer to a char pointer to receive the content-type of the downloaded object. This is the value read from the Content-Type: field. If you get NULL, it means that the server did not send a valid Content-Type header or that the protocol used does not support this.
The ct pointer is NULL or points to private memory. You must not free it. It gets freed automatically when you call curl_easy_cleanup(3) on the corresponding curl handle.
The modern way to get this header from a response is to instead use the curl_easy_header(3) function.
PROTOCOLS¶
This functionality affects http only
EXAMPLE¶
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(!res) {
/* extract the content-type */
char *ct = NULL;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
if(!res && ct) {
printf("Content-Type: %s\n", ct);
}
}
curl_easy_cleanup(curl);
}
}
AVAILABILITY¶
Added in curl 7.9.4
RETURN VALUE¶
curl_easy_getinfo(3) returns a CURLcode indicating success or error.
CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).
SEE ALSO¶
CURLOPT_HEADERFUNCTION(3), curl_easy_getinfo(3), curl_easy_header(3), curl_easy_setopt(3)
| 2025-10-29 | libcurl |